All APIs

Economic data API

One source for CPI, inflation, labour, GDP, and trade data from official statistical agencies.

First request

Retrieve the headline consumer price index for one country and month.

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

Example response Illustrative response · not a live request

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

GETConsumer Price Index/v1/economics/{country}/cpi

Retrieve the headline consumer price index for one country and month.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_cpi

GETInflation/v1/economics/{country}/inflation

Retrieve year-over-year, month-over-month, and year-to-date inflation for one month.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_inflation

GETUnemployment/v1/economics/{country}/unemployment

Retrieve the official unemployment rate for one observation period.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_unemployment

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

Retrieve the official labour-force participation rate for one observation period.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_labour_force_participation

GETGross Domestic Product/v1/economics/{country}/gdp

Retrieve national GDP for one quarter, always at current prices.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_gdp

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

Retrieve official real GDP growth for one quarter, measured at constant prices and expressed in percent.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_gdp_growth

GETMerchandise trade/v1/economics/{country}/trade

Retrieve exports, imports, and the exact merchandise-trade balance for one period. Services are excluded.

country: One supported uppercase country code; see this operation’s coverage list.
period: Omit it for the latest accepted complete release, or pass one exact period.
version_id: Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.

MCP · economics_get_trade