# GDP Growth API > How fast each economy is actually growing, on one comparable screen — real GDP growth from the OECD's official Quarterly National Accounts as an API, live, no key. Real GDP growth is the single most-watched macroeconomic number there is: it is the headline measure of whether an economy is expanding or in recession, it sets the backdrop for every central-bank decision, and the quarterly print moves bond, currency and equity markets. The OECD harmonises and seasonally adjusts the national accounts so the figures are genuinely comparable across countries. This API serves the two growth rates people actually quote — the quarter-on-quarter change (the latest quarter's pace) and the year-on-year change (growth versus the same quarter a year earlier), both for real, chain-linked-volume GDP. The board endpoint ranks every economy by its year-on-year growth, with the quarter-on-quarter move alongside, so you can see who is booming and who is shrinking. The momentum endpoint ranks by the latest quarter-on-quarter move — the freshest read on the cycle. The country endpoint gives one economy's GDP growth with a plain-language read (two consecutive negative quarters is the classic technical-recession marker). Each reading carries its own quarter and discontinued series are excluded, so the board is genuinely current. The headline GDP-growth cut — distinct from the annual IMF World Economic Outlook database (a yearly figure and forecast, not the live quarterly print), the leading-indicator and confidence boards (forward-looking soft data), and the generic multi-provider data aggregator. Figures are quarterly, in percent. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/gdp-api/..." ``` ## Pricing - **Free** (Free) — 800 calls/Mo, 2 req/s - **Starter** ($12/Mo) — 17,800 calls/Mo, 6 req/s - **Pro** ($35/Mo) — 90,200 calls/Mo, 16 req/s - **Business** ($81/Mo) — 501,000 calls/Mo, 40 req/s ## Endpoints ### Board #### `GET /v1/board` — Economies ranked by year-on-year real GDP growth, with quarter-on-quarter **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gdp-api/v1/board?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by year-on-year real GDP growth (chain-linked volume, seasonally adjusted), with the quarter-on-quarter move alongside. The headline read on whether an economy is expanding or in recession; sets the backdrop for central-bank policy. Each row carries its own quarter; discontinued series are excluded. Quarterly, cached a few hours.", "board": [ { "code": "IND", "name": "India", "gdp_qoq": 1.89, "gdp_yoy": 7.96, "quarter": "2026-Q1", "reading": "expanding strongly", "is_aggregate": false }, { "code": "DNK", "name": "Denmark", "gdp_qoq": 1.89, "gdp_yoy": 5.95, "quarter": "2026-Q1", "reading": "expanding strongly", "is_aggregate": false }, { "code": "IDN", "name": "Indonesia", "gdp_qoq": 1.37, "gdp_yoy": 5.46, "quarter": "2026-Q1", "reading": "expanding strongly", "is_aggregate": false }, { "code": "CHN", "name": "China (People’s Republic of)", "gdp_qoq": 1.3, "gdp_yoy": 5, "quarter": "2026-Q1", "reading": "expandin …(truncated, see openapi.json for full schema) ``` ### Momentum #### `GET /v1/momentum` — Economies ranked by the latest quarter-on-quarter GDP move **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gdp-api/v1/momentum?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by the latest quarter-on-quarter real GDP move — the freshest read on the cycle, the part markets react to first. Year-on-year alongside. Quarterly, cached a few hours.", "board": [ { "code": "IND", "name": "India", "gdp_qoq": 1.89, "gdp_yoy": 7.96, "quarter": "2026-Q1", "is_aggregate": false }, { "code": "DNK", "name": "Denmark", "gdp_qoq": 1.89, "gdp_yoy": 5.95, "quarter": "2026-Q1", "is_aggregate": false }, { "code": "KOR", "name": "Korea", "gdp_qoq": 1.83, "gdp_yoy": 3.78, "quarter": "2026-Q1", "is_aggregate": false }, { "code": "IDN", "name": "Indonesia", "gdp_qoq": 1.37, "gdp_yoy": 5.46, "quarter": "2026-Q1", "is_aggregate": false }, { "code": "CHN", "name": "China (People’s Republic of)", "gdp_qoq": 1.3, "gdp_yoy": 5, "quarter": "2026-Q1", "is_aggregate": false }, { "code": "BRA", …(truncated, see openapi.json for full schema) ``` ### Country #### `GET /v1/country` — One economy's real GDP growth, year-on-year and quarter-on-quarter **Parameters:** - `country` (query, required, string) — ISO-3 code or name Example: `USA` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gdp-api/v1/country?country=USA" ``` **Response:** ```json { "data": { "code": "USA", "name": "United States", "note": "One economy's real GDP growth, year-on-year and quarter-on-quarter (chain-linked volume, seasonally adjusted). A positive year-on-year change means output is above its level a year earlier; two consecutive negative quarter-on-quarter readings is the classic technical-recession marker. Quarterly, cached a few hours.", "source": "OECD Quarterly National Accounts (SDMX)", "quarter": "2026-Q1", "gdp_growth": { "qoq": 0.4, "yoy": 2.57, "reading": "growing" }, "is_aggregate": false }, "meta": { "timestamp": "2026-06-12T19:37:25.652Z", "request_id": "bbbb2498-d91e-4f3c-9baf-4676e49d5f3e" }, "status": "ok", "message": "Country GDP growth retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/gdp-api/v1/meta" ``` **Response:** ```json { "data": { "note": "board and momentum take countries_only (true to drop aggregates such as OECD, G20, EU). country takes country (ISO-3 code or name, required). meta takes no parameters. Growth figures are in percent; yoy is year-on-year, qoq is quarter-on-quarter. Quarterly data; a multi-hour protective cache fronts the OECD upstream.", "source": "OECD Quarterly National Accounts (DF_QNA_EXPENDITURE_GROWTH_OECD) via OECD SDMX API, real GDP, seasonally adjusted, live, keyless", "service": "gdp-api", "economies": 52, "endpoints": { "GET /v1/meta": "This document.", "GET /v1/board": "Economies ranked by year-on-year real GDP growth, with quarter-on-quarter (countries_only optional).", "GET /v1/country": "One economy's real GDP growth, year-on-year and quarter-on-quarter (country=USA).", "GET /v1/momentum": "Economies ranked by the latest quarter-on-quarter GDP move." }, "description": "GDP growth — how fast each economy is growing, live from the OECD's Quarterly National Accounts (no key). It serves the two real-GDP growth rates people quote: quarter-on-quarter (the latest quarter's pace) and year-on-year (versus the same quarter a year earlier), both seasonally adjusted. board ranks economies by year-on-year growth with quarter-on-quarter alongside; momentum ranks by the latest quarter-on-quarter move; country gives one economy's figures with a plain-language read. T …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/gdp-api OpenAPI spec: https://www.oanor.com/api/gdp-api/openapi.json