Endpoints
API endpoints reference
M2M mirror (AI agents, x402 / MPP)
The same GET routes below are also exposed under:
/api/v1/m2m/<same-path>on the site host (e.g. https://econdash.org/api/v1/m2m/stats). Unpaid calls return 402 with x402 and MPP challenges. Use this path for agent payments — not /api/proxy?path=/api/v1/m2m/... for the full pay-and-retry flow.
Details, token contracts, and examples: Agent payments.
Time Series
GET /api/v1/timeseries/{code}
Returns time series data for an indicator.
| Param | Type | Description |
|---|---|---|
| country | string | ISO3 code (required for trial) |
| start_date | date | YYYY-MM-DD |
| end_date | date | YYYY-MM-DD |
| limit | int | Max points (default 10000, trial max 1000) |
GET /api/v1/timeseries/{code}/top-countries
Returns top N countries by latest value.
| Param | Type | Description |
|---|---|---|
| limit | int | 1–50 (trial max 10) |
Metadata
GET /api/v1/indicators— List indicatorsGET /api/v1/sources— List data sources for indicators (Data Sources)GET /api/v1/news-sources— List RSS news sources (News Sources)GET /api/v1/indicators/{code}— Indicator metadataGET /api/v1/indicators/by-slug/{slug}— By URL slugGET /api/v1/indicators/{code}/countries— Countries with dataGET /api/v1/countries— List countriesGET /api/v1/countries/{iso3}/indicators— Indicators for countryGET /api/v1/categories— List categoriesGET /api/v1/stats— Database stats
News
GET /api/v1/news— News with optional indicator, category, country filters
Chat
Not available via API. Chat is only available on econdash.org.