# Investment Growth API > How fast each economy's businesses and governments are investing in new capital, on one comparable screen — real gross fixed capital formation growth from the OECD's official Quarterly National Accounts as an API, live, no key. Gross fixed capital formation — investment in machinery, buildings, infrastructure and equipment — is the most cyclical and forward-looking component of GDP: firms only commit to new plant and projects when they are confident about demand, so investment turns down before recessions and surges first in recoveries. Its year-on-year change is one of the cleanest reads on the business cycle, and a swing factor that moves the currency and the capex-exposed parts of the equity market. The OECD harmonises and seasonally adjusts the real, chain-linked-volume figures so they are genuinely comparable across countries. This API serves the two growth rates people quote — quarter-on-quarter (the latest quarter's pace) and year-on-year (versus the same quarter a year earlier) — for real investment. The board endpoint ranks every economy by its year-on-year investment growth, so you can see where capex is booming and where it is collapsing. The momentum endpoint ranks by the latest quarter-on-quarter move. The country endpoint gives one economy's investment growth with a plain-language read. Each reading carries its own quarter and discontinued series are excluded, so the board is genuinely current. The capital-investment / capex cut — distinct from the headline GDP-growth board (this isolates the investment component), the consumer-demand and trade boards, the annual IMF World Economic Outlook database, 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/investmentgrowth-api/..." ``` ## Pricing - **Free** (Free) — 805 calls/Mo, 2 req/s - **Starter** ($11/Mo) — 17,400 calls/Mo, 6 req/s - **Pro** ($35/Mo) — 88,500 calls/Mo, 16 req/s - **Business** ($79/Mo) — 496,000 calls/Mo, 40 req/s ## Endpoints ### Board #### `GET /v1/board` — Economies ranked by year-on-year real investment growth **Parameters:** - `countries_only` (query, optional, string) — Drop aggregate groups (true) Example: `true` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/investmentgrowth-api/v1/board?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by year-on-year real investment growth (gross fixed capital formation: machinery, buildings, infrastructure, equipment; chain-linked volume, seasonally adjusted). Investment is the most cyclical, forward-looking part of GDP — firms only commit capex when confident, so it leads the cycle. Each row carries its own quarter; discontinued series are excluded. Quarterly, cached a few hours.", "board": [ { "code": "SAU", "name": "Saudi Arabia", "quarter": "2026-Q1", "reading": "investment booming", "is_aggregate": false, "investment_qoq": 7.53, "investment_yoy": 17.06 }, { "code": "SVN", "name": "Slovenia", "quarter": "2026-Q1", "reading": "investment booming", "is_aggregate": false, "investment_qoq": 1.45, "investment_yoy": 12.78 }, { "code": "GRC", "name": "Greece", "quarter": "2026-Q1", "reading": "investment booming", "is_aggregate": false, "investment_qoq": -2.54, "investment_yoy": 12.07 }, { "code": "FIN", "name": "Finland", "quarter": "2026-Q1", …(truncated, see openapi.json for full schema) ``` ### Momentum #### `GET /v1/momentum` — Economies ranked by the latest quarter-on-quarter investment 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/investmentgrowth-api/v1/momentum?countries_only=true" ``` **Response:** ```json { "data": { "note": "Economies ranked by the latest quarter-on-quarter move in real investment (gross fixed capital formation) — the freshest read on the capex cycle. Year-on-year alongside. Quarterly, cached a few hours.", "board": [ { "code": "SAU", "name": "Saudi Arabia", "quarter": "2026-Q1", "is_aggregate": false, "investment_qoq": 7.53, "investment_yoy": 17.06 }, { "code": "FIN", "name": "Finland", "quarter": "2026-Q1", "is_aggregate": false, "investment_qoq": 6.5, "investment_yoy": 11.93 }, { "code": "LUX", "name": "Luxembourg", "quarter": "2026-Q1", "is_aggregate": false, "investment_qoq": 5.22, "investment_yoy": 4.43 }, { "code": "BRA", "name": "Brazil", "quarter": "2026-Q1", "is_aggregate": false, "investment_qoq": 3.52, "investment_yoy": -1.61 }, { "code": "AUS", "name": "Australia", "quarter": "2026-Q1", "is_aggregate": false, "investment_qoq": 3.01, "investment_yoy …(truncated, see openapi.json for full schema) ``` ### Country #### `GET /v1/country` — One economy's investment 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/investmentgrowth-api/v1/country?country=USA" ``` **Response:** ```json { "data": { "code": "USA", "name": "United States", "note": "One economy's real investment growth (gross fixed capital formation), year-on-year and quarter-on-quarter, chain-linked volume, seasonally adjusted. Investment leads the business cycle — a sustained fall flags a downturn ahead, a surge a recovery. Quarterly, cached a few hours.", "source": "OECD Quarterly National Accounts (SDMX)", "quarter": "2026-Q1", "is_aggregate": false, "investment_growth": { "qoq": 1.31, "yoy": 2.88, "reading": "investment growing" } }, "meta": { "timestamp": "2026-06-12T19:37:06.695Z", "request_id": "10e348f6-fc6d-4ac7-ab26-959b5bf790b8" }, "status": "ok", "message": "Country investment retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/investmentgrowth-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, gross fixed capital formation P51G) via OECD SDMX API, real, seasonally adjusted, live, keyless", "service": "investmentgrowth-api", "economies": 50, "endpoints": { "GET /v1/meta": "This document.", "GET /v1/board": "Economies ranked by year-on-year real investment growth (countries_only optional).", "GET /v1/country": "One economy's investment growth, year-on-year and quarter-on-quarter (country=USA).", "GET /v1/momentum": "Economies ranked by the latest quarter-on-quarter investment move." }, "description": "Investment growth — how fast each economy is investing in new capital (gross fixed capital formation: machinery, buildings, infrastructure, equipment), live from the OECD's Quarterly National Accounts (no key). It serves the quarter-on-quarter and year-on-year growth of real investment. board ranks economies by year-on-year investment growth; momentum ranks by the latest quarter-on-quarter move; country gives one economy's figures with a plain-languag …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/investmentgrowth-api OpenAPI spec: https://www.oanor.com/api/investmentgrowth-api/openapi.json