Narwhal API
English
All APIs

GDP growth API

Official real GDP growth rates by quarter.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth?period=2026-Q2" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "country": "USA",
  "period": "2026-Q2",
  "year_over_year": "2.4",
  "quarter_over_quarter": "0.503",
  "unit": "percent",
  "price_basis": "constant",
  "seasonal_adjustment": "seasonally_adjusted",
  "annualization": "not_annualized",
  "released_on": "2026-07-30"
}

Endpoints

GETGDP growth/v1/economics/{country}/gdp-growth
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 →
GETGDP growth history/v1/economics/{country}/gdp-growth/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_gdp_growth_history

API reference →

History

cURL
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/gdp-growth/observations?start=2026-Q2&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "observations": [
    {
      "country": "USA",
      "measure": "gdp_growth_yoy",
      "value": "2.4",
      "unit": "PCT",
      "transformation": "year_over_year",
      "period": "2026-Q2"
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T16:00:00Z"
}

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.

Coverage

View coverage →
AUS CAN DEU FRA GBR JPN MYS NLD SGP USA

Common questions

What does the response include?

Retrieve official real GDP growth measures for one quarter.

Which periods can I request?

YYYY-QN

What coverage is available?

Quarterly year-over-year and quarter-over-quarter growth are public for AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP, and USA. The optional year_to_date field appears only when the official source publishes it.

Make your first request

Get a free API key →