Primary sources
Every live stream comes from an official national publisher.
Read the methodology →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",
"released_on": "2026-07-30"
}Endpoints
GETGDP growth/v1/economics/{country}/gdp-growth
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.
version_id- Optional immutable publication version. Use `resource_version` from a `dataset.published` or `dataset.revised` event; omit to read the current admitted indicator.
MCP · economics_get_gdp_growth
GETGDP growth history/v1/economics/{country}/gdp-growth/observations
country- One supported uppercase country code; see this operation’s coverage list.
start- Inclusive first observation period. On Free and Basic, a start before your plan window is moved to the first period inside it. The response then includes start.
end- Inclusive last observation period.
limit- Maximum number of periods returned. Defaults to 100. A page may contain fewer periods; follow next_cursor.
cursor- The next_cursor from the previous page.
MCP · economics_get_gdp_growth_history
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
{
"country": "USA",
"as_of": "2026-08-12T00:00:00Z",
"observations": [
{
"period": "2026-Q2",
"year_over_year": "2.4",
"quarter_over_quarter": "0.503"
}
],
"next_cursor": null
}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 →Australia→Austria→Belgium→Canada→Chile→Colombia→Czechia→Germany→Denmark→Spain→Estonia→Finland→France→United Kingdom→Croatia→Ireland→Italy→Japan→Lithuania→Luxembourg→Latvia→Mexico→Malaysia→Netherlands→Norway→New Zealand→Pakistan→Philippines→Poland→Portugal→Qatar→Saudi Arabia→Singapore→Slovenia→Sweden→United States→
Explore related pages
API reference
Parameters and response fields.
Read the docs →Economic calendar API
Release schedules, status, and publication versions.
Explore the API →Economic data API
Official indicators for prices, labour, output, trade, and rates.
Explore the API →Common questions
What does the response include?
Retrieve official real GDP growth for one quarter, measured at constant prices and expressed in percent.
Which periods can I request?
YYYY-QN
What coverage is available?
Quarterly year-over-year and quarter-over-quarter growth follow the country list below. The optional year_to_date field appears only when the official source publishes it.