All APIs

Prices and inflation API

Query official CPI and inflation data by country through REST or MCP. Retrieve the latest accepted value, an exact period or dated history.

First request

Quickstart →
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; see this operation’s coverage list.
period
Omit it for the latest accepted complete release, or pass one exact period.

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.

MCP · economics_get_inflation

Sources and methodology

Explicit periods

Omit it for the latest accepted complete release, or pass one exact period.

REST and MCP

Use one API key for current and historical data through REST or MCP.

CPI and inflation are live today. Other price measures shown in the grid are not currently live.

Indicators

Countries

Explore related pages

Economic data API

Official indicators for prices, labour, output, trade, and rates.

Explore the API →

Common questions

Are both CPI levels and inflation rates available?

Yes. Live coverage includes CPI index levels and inflation rates.

Can I request a specific period?

Yes. You can request an exact period, retrieve dated history or query the latest accepted value.

Where do the statistics come from?

They are official statistics from national publishers, organized by country.

Make your first request

Get a free API key →