Macro & Market Endpoints
Query endpoints for macro indicators and market-wide data.
GET /api/v1/macro/indicator
Macro economic indicators.
Query Parameters:
| Parameter | Type | Filter Type | Description |
|---|---|---|---|
indicator_name | string | exact | Indicator name |
period | string | exact | Period (e.g. 2024-01) |
source | string | exact | Data source |
date_from | string | date range | Start date |
date_to | string | date range | End date |
Example:
curl -H "F-API-KEY: fk-xxxxx" \ "https://finance-api.xp-java.workers.dev/api/v1/macro/indicator?indicator_name=CPI&limit=12"GET /api/v1/market/margin-trading
Margin trading balance and flows by market.
Query Parameters:
| Parameter | Type | Filter Type | Description |
|---|---|---|---|
market | string | exact | Market identifier |
trade_date | string | exact | Trade date |
source | string | exact | Data source |
date_from | string | date range | Start date |
date_to | string | date range | End date |
GET /api/v1/market/hsgt-flow
Shanghai/Shenzhen-Hong Kong Stock Connect flows.
Query Parameters:
| Parameter | Type | Filter Type | Description |
|---|---|---|---|
direction | string | exact | Flow direction (northbound, southbound) |
trade_date | string | exact | Trade date |
source | string | exact | Data source |
date_from | string | date range | Start date |
date_to | string | date range | End date |