Which series can I request?
Use GET /indicators for the catalog. Each entry includes id, name, country, source, unit, and whether a server-side key is required.
Economic Indicators API
FRED, World Bank, BLS
Latest + history
Long-TTL cache
Macro series. One catalog.
GDP, inflation, employment, and rates from three government sources, with latest values and cached history for dashboards and agents.
Catalog · discoveryLatest · one observationHistory · limit 1-60Rates · bundled
Pull the latest observation.
This calls GET /series/:id/latest for World Bank series that do not need a server-side key. Pick a catalog id to see the current value.
Request builder
Allowlisted series ids only.
GET /series/:id/latest
Output preview
Live response from the API, plus the exact request to reproduce it.
Loading latest value...
Why Economic Indicators API
Macro data, cached cleanly.
Latest in one hop
GET /series/:id/latest returns the current observation without pulling a full window.
History with a cap
GET /series/:id accepts limit 1 to 60 (default 12). BLS series cap at 5 observations.
Three official sources
FRED, World Bank, and BLS behind one catalog so dashboards do not juggle three clients.
Keyless World Bank
World Bank series work without an upstream key. FRED and BLS use server-side keys.
Catalog discovery
GET /indicators lists id, name, country, source, unit, and requiresApiKey.
Long-TTL cache
fromCache and updatedAt tell you when the series was last assembled.
/api/v1/economic-indicators
Endpoints, at a glance.
Catalog, history, latest values, and a bundled interest-rate summary. All GET, all cached.
GET/api/v1/economic-indicators/series/:id/latest
Latest value
Most recent observation for a catalog id, plus cache status.
GET/api/v1/economic-indicators/series/:id
History
Observation window. limit 1 to 60, default 12. BLS caps at 5.
GET/api/v1/economic-indicators/indicators
Catalog
Every series with source, unit, and whether a server-side key is needed.
GET/api/v1/economic-indicators/interest-rates
Interest rates
Bundled Fed Funds (FRED) and US real interest rate (World Bank).
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Catalog indicator id path parameter, e.g. us_gdp_growth. |
| limit | integer | no | History observations 1 to 60, default 12. BLS caps at 5. |
Error reference
Failures you can plan for.
Unknown ids return 404. Empty observation sets return 503.
400Validation Error
Invalid limit or malformed indicator id.
401Authentication Error
Missing or invalid gateway API key. Send x-api-key or api_key with every request.
404Unknown Indicator
Indicator id is not in the catalog, or the route does not exist.
429Rate Limit Error
More than 200 requests in a 15-minute window.
503Upstream Unavailable
Upstream source failed or returned no observations.
Example error response
{
"success": false,
"error": "Unknown indicator",
"correlationId": "req_abc123"
}FAQ
API questions developers ask first.
How do I get just the latest observation?
GET /series/:id/latest returns the most recent date/value pair plus cache status. GET /series/:id returns history with limit 1 to 60 (default 12).
Do I need FRED or BLS keys?
Not on your side. World Bank series are keyless. FRED and BLS use server-side keys and are flagged requiresApiKey in the catalog. Unknown ids return 404.
Why does BLS history look short?
BLS series cap at 5 observations regardless of a higher limit. Other sources honor limit up to 60.
How do I authenticate requests?
Send your Datpaq API key as an x-api-key header or an api_key query parameter. Keys are created in the Datpaq dashboard and a free tier is included.
Add macro series in one request.
GDP, inflation, employment, and rates from FRED, World Bank, and BLS, with caching that keeps dashboards fast.