All APIs

Inflation API

Monthly inflation rates from official national sources.

First request

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

Example response Illustrative response · not a live request

{
  "country": "USA",
  "period": "2026-07",
  "year_over_year": "3.651",
  "month_over_month": "0.153",
  "year_to_date": "0.755",
  "unit": "percent",
  "released_on": "2026-08-12"
}

Endpoints

GETInflation/v1/economics/{country}/inflation

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 →

GETInflation history/v1/economics/{country}/inflation/observations

country: One supported uppercase country code: AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA.
start: Inclusive first observation period.
end: Inclusive last observation period.
limit: Maximum observations returned. Defaults to 100.
cursor: The next_cursor from the previous page.

MCP · economics_get_inflation_history

API reference →

History

cURL

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/inflation/observations?start=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "observations": [
    {
      "country": "USA",
      "measure": "inflation_yoy",
      "value": "3.2",
      "unit": "PCT",
      "transformation": "year_over_year",
      "period": "2026-07"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}