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 |
|---|---|---|---|---|
date_range | string | No | Date range 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": "685ea7ca720f2c38da2c2bb3",
"category_ids": [
"6523c4b376022da50d4fe538"
],
"analyst_ids": [
"6523c4b376022da50d4fe535"
],
"symbol": null,
"sector": null,
"tags": null,
"title": "JS Daily Highlights - SBP Forex reserves and Oil & Gas discovery update",
"description": "",
"thumbnail": "148/685ea7ca720f2c38da2c2bb3.webp",
"created": "2025-06-27T14:16:42.04Z",
"modified": "2025-06-27T14:16:44.158Z"
},
{
"id": "685e44512c4bf9b6397f2188",
"category_ids": [
"6523c4b376022da50d4fe537"
],
"analyst_ids": [
"6511241f528f5a5108e07563"
],
"symbol": [
"AGTL"
],
"sector": [
"0801"
],
"tags": null,
"title": "AGTL: Agriculture slowdown weighs on volumes",
"description": "",
"thumbnail": "148/685e44512c4bf9b6397f2188.webp",
"created": "2025-06-27T07:12:17.818Z",
"modified": "2025-06-27T07:12:19.37Z"
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Research report unique ID |
category_ids | array | Category IDs this report belongs to |
analyst_ids | array | Analyst IDs who authored the report |
symbol | array | Stock symbols covered in the report |
sector | array | Sector codes covered |
tags | array | Report tags for classification |
title | string | Report title |
description | string | Report description |
thumbnail | string | URL to report thumbnail image |
created | string (ISO 8601) | Report creation timestamp |
modified | string (ISO 8601) | Report last modified timestamp |
Error Responses
For detailed Common Error responses, see the Error Handling.
Invalid Date Range (200)
{
"status": "error",
"message": "invalid `date_range` provided"
}
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