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",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

Endpoints

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

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

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_cpi

API reference →History →

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: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_inflation

API reference →History →

GETUnemployment/v1/economics/{country}/unemployment

Retrieve the official unemployment rate for one observation period.

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_unemployment

API reference →History →

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: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_labour_force_participation

API reference →History →

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

Retrieve current-price national GDP for one quarter.

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_gdp

API reference →History →

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

Retrieve official real GDP growth measures for one quarter.

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_gdp_growth

API reference →History →

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

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

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.

MCP · economics_get_trade

API reference →History →

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

Retrieve the merchandise-export total for one country and period.

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.
partner: Accepted by the contract, but filtered partner totals are not published in the current beta.
product: An HS product code. Supply it together with classification.
classification: The Harmonized System edition. Supply it together with product.

MCP · economics_get_trade_exports

API reference →History →

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

Retrieve the merchandise-import total for one country and period.

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
period: Omit it for the latest accepted complete release, or pass one exact period.
partner: Accepted by the contract, but filtered partner totals are not published in the current beta.
product: An HS product code. Supply it together with classification.
classification: The Harmonized System edition. Supply it together with product.

MCP · economics_get_trade_imports

API reference →History →