Endpoints

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.

GET /api/v1/timeseries/{code}/top-countries

Returns top N countries by latest value.

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.

Chat

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