Official economics,one predictable API.

Current CPI, inflation, labour, GDP, and merchandise-trade releases from official statistical agencies across nine countries.

See the response View endpoints

Economics APILive public beta

api.narwhalapi.com 200 OK

GET/v1/economics/USA/cpi

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

Official releases without nine different source systems.

Primary sources

Each live stream comes from the responsible national statistical agency.

Explicit periods

Monthly, quarterly, and release-specific timing stays visible in every response.

REST and MCP

Both interfaces expose the same nine operations, schemas, authentication, and quota.

Nine operations across nine countries.

AUS, CAN, DEU, FRA, GBR, JPN, MYS, SGP, and USA share one country-first contract. Values remain decimal strings, release dates stay explicit, and private source machinery stays out of customer JSON.

country: ISO 3166-1 alpha-3 country code.
period: The exact source period returned by the operation.
value / rate: Decimal-safe observation value or percentage rate.
released_on: Official release date for the accepted publication.

Endpoint planv1

GET/v1/economics/{country}/cpi

Headline CPI

First release

GET/v1/economics/{country}/inflation

Inflation rates

First release

GET/v1/economics/{country}/unemployment

Unemployment rate

First release

GET/v1/economics/{country}/labour-force-participation

Labour-force participation

First release

GET/v1/economics/{country}/gdp

Gross domestic product

First release

GET/v1/economics/{country}/gdp-growth

GDP growth

First release

GET/v1/economics/{country}/trade

Merchandise-trade balance

First release

GET/v1/economics/{country}/trade/exports

Merchandise exports

First release

GET/v1/economics/{country}/trade/imports

Merchandise imports

First release

These endpoints are available in the public economics beta. Every request requires an API key.

Narwhal mascot checking official economic data

A release is more than a number.

Narwhal keeps the country, period, unit or currency, release date, seasonal adjustment, price basis, and other required interpretation fields attached to the value that needs them.

Start with one economics request.

Request a beta key and use the same contract across all nine live countries.

Request a beta key Read the docs