Quick Start

Trial without a key

Get database statistics:

curl "https://econdash.org/api/v1/stats"

Response: JSON with total_indicators, total_countries, total_data_points, etc.

Trial limits: 300 requests/day, 30/minute, 10 countries, 50 indicators.

Get time series (trial)

Trial: use ?country= (required) with one of USA, CHN, DEU, JPN, GBR, FRA, IND, BRA, RUS, KOR.

curl "https://econdash.org/api/v1/timeseries/{code}?country=USA&limit=5"

Outside the trial (another country or indicator, or over the free quota) the same URL answers 402 Payment Required with payment options: use an API key or pay for the call.

API key or pay-per-call

Create an API key in the dashboard and call the same host (Nginx forwards /api/v1/* to the backend):

https://econdash.org/api/v1/...

Authenticate with a Bearer token (the raw key string):

Authorization: Bearer ed_your_key_here

Agents can pay per call on the same /api/v1/... URLs (x402 / MPP) when they get a 402. /api/proxy is an internal site endpoint, not for integrations, and it is restricted. Do not use it.

AI agents — x402 & MPP

Free trial data needs no payment. For everything else /api/v1/... answers 402 with x402 (Base), MPP Tempo and MPP Solana challenges; pay and retry the same request. See Agent payments (x402 & MPP) and the official specs: x402, MPP.

Python

pip install econdash, then EconDash().get_series("gdp-nominal", "USA"). See Python SDK.