# IMF Economic Data API > Live macroeconomic data from the International Monetary Fund's World Economic Outlook — the official cross-country numbers, served from the public IMF DataMapper, no key, nothing stored. GDP, real GDP growth, inflation, gross government debt, unemployment, the current-account balance, GDP per capita and 120-plus other indicators for 200-plus countries, with the IMF's historical record back to 1980 and its forecasts several years into the future. The indicators endpoint lists every series the IMF publishes, with an optional search. The series endpoint returns one indicator's full time series for one country — every year, actual and projected. The country endpoint returns a snapshot of a country's headline numbers — real GDP growth, inflation, government debt as a share of GDP, unemployment, current-account balance and GDP per capita — across recent and forecast years. Compare economies, track the debt and growth outlook and pull the same numbers policymakers use, as live JSON. This is the IMF macro / economic-indicator cut — distinct from the FX-rate, central-bank and market-data APIs in the catalogue. ## 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/imf-api/..." ``` ## Pricing - **Free** (Free) — 20,000 calls/Mo, 3 req/s - **Analyst** ($8/Mo) — 225,000 calls/Mo, 10 req/s - **Pro** ($24/Mo) — 900,000 calls/Mo, 28 req/s - **Scale** ($56/Mo) — 3,100,000 calls/Mo, 60 req/s ## Endpoints ### Indicators #### `GET /v1/indicators` — Every IMF indicator **Parameters:** - `search` (query, optional, string) — Filter by keyword Example: `inflation` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/imf-api/v1/indicators?search=inflation" ``` **Response:** ```json { "data": { "count": 2, "source": "IMF", "indicators": [ { "code": "PCPIPCH", "unit": "Annual percent change", "label": "Inflation rate, average consumer prices", "source": "World Economic Outlook (April 2026)" }, { "code": "PCPIEPCH", "unit": "Annual percent change", "label": "Inflation rate, end of period consumer prices", "source": "World Economic Outlook (April 2026)" } ] }, "meta": { "timestamp": "2026-06-12T01:42:59.719Z", "request_id": "8d7a65c7-923d-45f6-9886-f10371fd8b69" }, "status": "ok", "message": "Indicators retrieved successfully", "success": true } ``` ### Series #### `GET /v1/series` — One indicator time series for one country **Parameters:** - `indicator` (query, required, string) — Indicator code Example: `NGDP_RPCH` - `country` (query, required, string) — ISO-3 country code Example: `USA` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/imf-api/v1/series?indicator=NGDP_RPCH&country=USA" ``` **Response:** ```json { "data": { "note": "Includes IMF historical data and forecasts; later years are projections.", "count": 52, "source": "IMF", "values": { "1980": -0.3, "1981": 2.5, "1982": -1.8, "1983": 4.6, "1984": 7.2, "1985": 4.2, "1986": 3.5, "1987": 3.5, "1988": 4.2, "1989": 3.7, "1990": 1.9, "1991": -0.1, "1992": 3.5, "1993": 2.8, "1994": 4, "1995": 2.7, "1996": 3.8, "1997": 4.4, "1998": 4.5, "1999": 4.8, "2000": 4.1, "2001": 1, "2002": 1.7, "2003": 2.8, "2004": 3.8, "2005": 3.5, "2006": 2.8, "2007": 2, "2008": 0.1, "2009": -2.6, "2010": 2.7, "2011": 1.6, "2012": 2.3, "2013": 2.1, "2014": 2.5, "2015": 2.9, "2016": 1.8, "2017": 2.5, "2018": 3, "2019": 2.6, "2020": -2.1, "2021": 6.2, "2022": 2.5, "2023": 2.9, "2024": 2.8, "2025": 2.1, "2026": 2.3, "2027": 2.1, "2028": 2.1, "2029": 1.9, "2030": 1.8, "2031": 1.8 }, "country": …(truncated, see openapi.json for full schema) ``` ### Country #### `GET /v1/country` — A country headline macro snapshot **Parameters:** - `country` (query, required, string) — ISO-3 country code Example: `DEU` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/imf-api/v1/country?country=DEU" ``` **Response:** ```json { "data": { "name": "Germany", "note": "latest values may be IMF forecasts. recent shows the last six years (actual + projected).", "source": "IMF", "country": "DEU", "indicators": { "LUR": { "label": "Unemployment rate (%)", "recent": { "2026": 3.9, "2027": 3.5, "2028": 3.2, "2029": 3, "2030": 2.9, "2031": 2.9 }, "latest_year": "2031", "latest_value": 2.9 }, "NGDPDPC": { "label": "GDP per capita (current US$)", "recent": { "2026": 65302.893, "2027": 67613.107, "2028": 69804.854, "2029": 72087.756, "2030": 74263.697, "2031": 76425.902 }, "latest_year": "2031", "latest_value": 76425.902 }, "PCPIPCH": { "label": "Inflation, avg consumer prices (% change)", "recent": { "2026": 2.7, "2027": 2.3, "2028": 2, "2029": 2.2, "2030": 2.2, "2031": 2.1 }, "latest_year": "2031", "latest_value": 2.1 …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/imf-api/v1/meta" ``` **Response:** ```json { "data": { "note": "country is an ISO-3 code (USA, DEU, CHN, IND). Find indicator codes via /v1/indicators (e.g. NGDP_RPCH = real GDP growth, PCPIPCH = inflation, GGXWDG_NGDP = govt debt % of GDP). Later years in any series are IMF projections.", "source": "IMF DataMapper (imf.org/external/datamapper/api/v1, live)", "service": "imf-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/series": "One indicator's full time series for one country (indicator=NGDP_RPCH&country=USA).", "GET /v1/country": "A country's headline macro snapshot — growth, inflation, debt, unemployment, current account, GDP/capita (country=USA).", "GET /v1/indicators": "Every IMF indicator (code, label, unit); optional search=." }, "description": "Live macroeconomic data from the IMF World Economic Outlook via the public DataMapper API — GDP, growth, inflation, government debt, unemployment, current account and 120+ other indicators for 200+ countries, with history back to 1980 and forecasts several years out. The indicators endpoint lists every series; the series endpoint returns one indicator's full time series for one country (actual and forecast); the country endpoint returns a snapshot of a country's headline numbers (GDP growth, inflation, debt, unemployment, current account, GDP per capita). Live, no key, nothing stored. The IMF macro / economic-indicator cut — distinct from the FX-r …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/imf-api OpenAPI spec: https://www.oanor.com/api/imf-api/openapi.json