Economic Reports

Retrieve economic research reports analyzing macro-economic trends and market conditions.

GET/3.0/research/economic-reports

Description

This endpoint returns research reports focused on economic analysis, including macroeconomic indicators, monetary and fiscal policy, interest rate outlook, inflation trends, and impact on equity markets.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	No	Stock symbol to filter company reports	UBL
date_range	string	No	Start date for filtering (format: YYYY-MM-DD:YYYY-MM-DD)	2024-01-01:2024-12-31
offset	integer	No	Number of records to skip for pagination	0
count	integer	No	Maximum number of records to return (default: 50)	25

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "count": 2,
  "offset": 0,
  "total": 6,
  "data": [
    {
      "id": "64ad34123c85e1d1d902c9dc",
      "ref": 301,
      "cid": 18,
      "uid": 1003,
      "cat_ids": ["64ad34123c85e1d1d902c9a3"],
      "an_ids": ["507f1f77bcf86cd799439013"],
      "sy": [],
      "sc": [],
      "ic": ["KSE-100", "KSE-ALL"],
      "tags": ["inflation", "monetary-policy", "interest-rates", "market-outlook"],
      "ty": "Economic Analysis",
      "tt": "Pakistan Economy: Inflation Trends and Monetary Policy Outlook",
      "dsc": "Macroeconomic analysis examining inflation dynamics, SBP monetary policy stance, interest rate expectations, and implications for equity market valuations.",
      "str": "Macro Analysis",
      "np": 16,
      "thm": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9dc/thumbnail.jpg",
      "file": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9dc/report.pdf",
      "vid": null,
      "crt": "2024-11-20T08:30:00+05:00",
      "mod": "2024-11-20T08:30:00+05:00",
      "cats": [
        {
          "id": "64ad34123c85e1d1d902c9a3",
          "ref": 53,
          "cid": 18,
          "name": "Economic Analysis",
          "rows": 8,
          "crt": "2024-01-01T00:00:00+05:00",
          "mod": "2024-01-01T00:00:00+05:00"
        }
      ]
    }
  ]
}

Response Fields

Same as Company Reports. See Company Reports documentation for field descriptions.

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get All Economic Reports

curl -X GET "https://csapis.com/3.0/research/economic-reports" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Macro Analysis: Understand macroeconomic trends and their impact
• Portfolio Positioning: Adjust portfolio based on macro outlook
• Valuation Context: Place company valuations in macro context
• Policy Impact: Assess impact of monetary and fiscal policies
• Market Timing: Inform market timing and allocation decisions