# 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"
```

### 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"
```

### 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"
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/imf-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/imf-api
OpenAPI spec: https://www.oanor.com/api/imf-api/openapi.json