Economics API reference

Nine official economic-data operations across nine countries.

All economics routes return the latest accepted complete official release by default. 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.
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

AUS, CAN, DEU, FRA, GBR, JPN, MYS, SGP, and USA.

Every country supports the same nine public operations.

Operations

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`

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

Public discovery is limited to the nine routes and nine countries above. Indonesia, regional routes, Commodities, and FX are not part of the public beta.

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