Economics API reference

Latest releases and historical observations, with coverage listed by country and indicator.

Nine routes return the latest accepted official release. Nine matching /observations routes return the current accepted time series. REST and MCP use the same schemas and consume the same monthly quota.

Base URL and parameters

REST base path

https://api.narwhalapi.com/v1/economics/{country}

country is a supported uppercase ISO alpha-3 code.
period is optional. Omit it for the latest release or pass the operation's month, quarter, or year format.
Core economics endpoints such as /v1/economics/{country}/cpi and their MCP tools may return provisional first estimates of headline figures without identifying them as provisional in the response; Narwhal API replaces these values when the source publishes final figures.
Every request requires the Bearer header described in Authentication.

Request one known period

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Countries

36 Countries

AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA

Coverage varies by operation and country. Each operation lists its supported countries.

Latest releases

Open an operation page for exact parameters, accepted period formats, response fields, examples, errors, freshness, and current limits.

Operation	REST path	Period
Consumer Price Index	`/v1/economics/{country}/cpi`	`YYYY-MM`
Inflation	`/v1/economics/{country}/inflation`	`YYYY-MM`
Unemployment	`/v1/economics/{country}/unemployment`	`YYYY, YYYY-MM, or YYYY-QN`
Labour-force participation	`/v1/economics/{country}/labour-force-participation`	`YYYY, YYYY-MM, or YYYY-QN`
Gross Domestic Product	`/v1/economics/{country}/gdp`	`YYYY-QN`
GDP growth	`/v1/economics/{country}/gdp-growth`	`YYYY-QN`
Merchandise trade	`/v1/economics/{country}/trade`	`YYYY or YYYY-MM`
Merchandise exports	`/v1/economics/{country}/trade/exports`	`YYYY or YYYY-MM`
Merchandise imports	`/v1/economics/{country}/trade/imports`	`YYYY or YYYY-MM`

Historical observations

Historical routes accept start, end, limit, and cursor. Results are oldest-first and describe the current accepted series, not every past publication vintage.

Operation	REST path	Period
Consumer Price Index history	`/v1/economics/{country}/cpi/observations`	`YYYY-MM`
Inflation history	`/v1/economics/{country}/inflation/observations`	`YYYY-MM`
Unemployment history	`/v1/economics/{country}/unemployment/observations`	`YYYY, YYYY-MM, or YYYY-QN`
Labour-force participation history	`/v1/economics/{country}/labour-force-participation/observations`	`YYYY, YYYY-MM, or YYYY-QN`
Gross Domestic Product history	`/v1/economics/{country}/gdp/observations`	`YYYY-QN`
GDP growth history	`/v1/economics/{country}/gdp-growth/observations`	`YYYY-QN`
Merchandise trade history	`/v1/economics/{country}/trade/observations`	`YYYY-MM`
Merchandise exports history	`/v1/economics/{country}/trade/exports/observations`	`YYYY-MM`
Merchandise imports history	`/v1/economics/{country}/trade/imports/observations`	`YYYY-MM`

Yield curves

Yield curves for the US, the UK, Germany, Japan, and Canada are available with a Narwhal API key.

United States yield curve →United Kingdom yield curve →Germany yield curve →Japan yield curve →Canada yield curve →

Field conventions

Field or rule	Meaning
`country`	The requested ISO alpha-3 country code.
`period`	The exact official month, quarter, or year represented by the response.
`released_on`	The official publication date, not Narwhal's retrieval time.
Decimal strings	Numeric economic values are strings to preserve exact decimal representation.
Units and bases	Rates, currencies, price bases, annualization, coverage, and index bases remain explicit where applicable.
Missing releases	Narwhal fails closed instead of inventing, carrying forward, or converting missing values to zero.

OpenAPI and discovery

Current public-beta limits

Government bond yield curves for the US, the UK, Germany, Japan, and Canada. Retrieve one source date or a paginated history through REST and MCP.

Indonesia and regional routes are not part of the public Economics beta.

See Errors and quota for missing-series and service-unavailable behavior.