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 indicators
GET /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 metadata
GET /api/v1/indicators/by-slug/{slug} — By URL slug
GET /api/v1/indicators/{code}/countries — Countries with data
GET /api/v1/countries — List countries
GET /api/v1/countries/{iso3} — Country data
GET /api/v1/countries/{iso3}/indicators — Indicators for country
GET /api/v1/categories — List categories
GET /api/v1/stats — Database stats

News

GET /api/v1/news — News with optional indicator, category, country filters
GET /api/v1/news/{news_id} — Single news item by ID

AI Citation

GET /api/v1/cite/{country}/{indicator} — AI-optimized citation data for key economic indicators (free, no payment required). Both path segments accept friendly aliases — country (us, eu, cn) and indicator (cpi, gdp, unemployment, …), e.g. /api/v1/cite/us/cpi, /api/v1/cite/eu/gdp, /api/v1/cite/us/unemployment. Returns structured JSON with the latest value, trend, source, and pre-formatted citation strings (text, short, markdown) — a single snapshot, not a full time series. Designed for AI crawler ingestion.

M2M Discovery

GET /api/v1/m2m/openapi.json — OpenAPI 3.1 spec for all 15 M2M endpoints. Free, no payment required. Use for agent route discovery before paying.

OKF Knowledge Bundle

GET /okf/index.md — entry point to the Open Knowledge Format v0.1 bundle: a machine-readable Markdown knowledge graph for AI agents. Free, no payment required. Human-readable overview at econdash.org/okf.
Structure: /okf/metrics/index.md (indicator catalog), /okf/concepts/index.md (economic explainers), /okf/data-sources/index.md (providers).
Metadata only — names, descriptions, units, coverage ranges, observation counts, sources and chart links. No raw time-series values; full numeric data requires a subscription or per-query agent payment (x402 / MPP).
Regenerated weekly from the live database, so coverage (date ranges, observation counts, new indicators) stays current.

Chat

Not available via API. Chat is only available on econdash.org.

Endpoints