All APIs

Economic output API

Read official GDP levels and GDP growth by country through REST or MCP. Request the latest accepted value, an exact period or dated history.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "country": "USA",
  "period": "2026-Q2",
  "value": "31000100000000",
  "currency": "USD",
  "price_basis": "current",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "annualized",
  "released_on": "2026-07-30"
}

Endpoints

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

Retrieve current-price national GDP for one quarter.

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_gdp

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

Retrieve official real GDP growth measures for one quarter.

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_gdp_growth

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.

GDP and GDP growth are live today. Other output 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

Does live coverage include GDP growth?

Yes. Both GDP levels and GDP growth are live today.

Can I query a particular reporting period?

Yes. You can request an exact period or retrieve dated history.

Where does the output data come from?

The API publishes official statistics from national publishers, organized by country.

Make your first request

Get a free API key →