# BIS Central Bank Policy Rates API
> The headline interest rate of every major central bank in the world, side by side, served live from the Bank for International Settlements' open statistics API — no key, nothing cached. The BIS compiles the official policy rate for around 40 monetary authorities — the Federal Reserve, the ECB, the Bank of England, the Bank of Japan and dozens more — onto one consistent monthly series. The policy-rates endpoint returns the current rate for every central bank in a single call, ranked from highest to lowest, so you can see the whole global rate landscape at a glance: in mid-2026 Türkiye near 37% at the top and the US Federal Reserve around 3.6%. The country endpoint returns one central bank's policy rate with its full history and its latest move. The changes endpoint compares each bank's two most recent readings and reports who has hiked, who has cut and who is on hold, with the size of the move — the global rate-cycle dashboard. Everything is the BIS's own compiled data, live, nothing stored; rates are monthly. This is the global monetary-policy layer for any macro, fixed-income, forex or research app. Distinct from single-central-bank APIs — this is every central bank's policy rate in one place, from the BIS. 3 endpoints, no key on our side.

## 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/bis-api/..."
```

## Pricing
- **Free** (Free) — 2,200 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 36,000 calls/Mo, 6 req/s
- **Pro** ($28/Mo) — 210,000 calls/Mo, 15 req/s
- **Mega** ($66/Mo) — 1,050,000 calls/Mo, 40 req/s

## Endpoints

### BIS

#### `GET /v1/changes` — Global rate-cycle dashboard

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

**Response:**
```json
{
    "data": {
        "note": "compares the two most recent monthly readings per central bank",
        "source": "Bank for International Settlements",
        "changes": [
            {
                "as_of": "2026-05",
                "country": "Israel",
                "direction": "cut",
                "change_bps": -25,
                "country_code": "IL",
                "policy_rate_pct": 3.75
            },
            {
                "as_of": "2026-05",
                "country": "Iceland",
                "direction": "hike",
                "change_bps": 25,
                "country_code": "IS",
                "policy_rate_pct": 7.75
            },
            {
                "as_of": "2026-05",
                "country": "Norway",
                "direction": "hike",
                "change_bps": 25,
                "country_code": "NO",
                "policy_rate_pct": 4.25
            },
            {
                "as_of": "2026-05",
                "country": "Mexico",
                "direction": "cut",
                "change_bps": -25,
                "country_code": "MX",
                "policy_rate_pct": 6.5
            },
            {
                "as_of": "2026-05",
                "country": "South Africa",
                "direction": "hike",
                "change_bps": 25,
                "country_code": "ZA",
                "policy_rate_pct": 7
            },
            {
                "as_of": "2026-05",
                "
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/country` — One central bank policy rate + history

**Parameters:**
- `country` (query, required, string) — Country code (US, GB, JP, XM for euro area) Example: `US`
- `history` (query, optional, string) — Number of past months (default 24) Example: `12`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/bis-api/v1/country?country=US&history=12"
```

**Response:**
```json
{
    "data": {
        "unit": "% per year",
        "as_of": "2026-05",
        "source": "Bank for International Settlements",
        "country": "United States",
        "history": [
            {
                "date": "2025-06",
                "rate_pct": 4.375
            },
            {
                "date": "2025-07",
                "rate_pct": 4.375
            },
            {
                "date": "2025-08",
                "rate_pct": 4.375
            },
            {
                "date": "2025-09",
                "rate_pct": 4.125
            },
            {
                "date": "2025-10",
                "rate_pct": 3.875
            },
            {
                "date": "2025-11",
                "rate_pct": 3.875
            },
            {
                "date": "2025-12",
                "rate_pct": 3.625
            },
            {
                "date": "2026-01",
                "rate_pct": 3.625
            },
            {
                "date": "2026-02",
                "rate_pct": 3.625
            },
            {
                "date": "2026-03",
                "rate_pct": 3.625
            },
            {
                "date": "2026-04",
                "rate_pct": 3.625
            },
            {
                "date": "2026-05",
                "rate_pct": 3.625
            }
        ],
        "indicator": "Central bank policy rate",
        "country_code": "US",
        "last_change_bps": 0,
        "policy_ra
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/policy_rates` — Every central bank policy rate, ranked

**Parameters:**
- `all` (query, optional, string) — true to include legacy/euro-legacy series

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

**Response:**
```json
{
    "data": {
        "unit": "% per year",
        "count": 39,
        "rates": [
            {
                "as_of": "2026-05",
                "country": "Türkiye",
                "country_code": "TR",
                "policy_rate_pct": 37
            },
            {
                "as_of": "2025-06",
                "country": "Argentina",
                "country_code": "AR",
                "policy_rate_pct": 29
            },
            {
                "as_of": "2026-05",
                "country": "Russia",
                "country_code": "RU",
                "policy_rate_pct": 14.5
            },
            {
                "as_of": "2026-05",
                "country": "Brazil",
                "country_code": "BR",
                "policy_rate_pct": 14.5
            },
            {
                "as_of": "2026-05",
                "country": "Colombia",
                "country_code": "CO",
                "policy_rate_pct": 11.25
            },
            {
                "as_of": "2026-05",
                "country": "Iceland",
                "country_code": "IS",
                "policy_rate_pct": 7.75
            },
            {
                "as_of": "2026-05",
                "country": "South Africa",
                "country_code": "ZA",
                "policy_rate_pct": 7
            },
            {
                "as_of": "2026-05",
                "country": "Mexico",
                "country_code": "MX",
                "poli
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "source": "Bank for International Settlements stats API — WS_CBPOL (live)",
        "service": "bis-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/changes": "Global rate-cycle dashboard — who hiked, cut or held.",
            "GET /v1/country": "One central bank's policy rate + history + last move (country=US, GB, JP, XM).",
            "GET /v1/policy_rates": "Every central bank's current policy rate, ranked (all=true to include legacy/euro-legacy series)."
        },
        "description": "The headline policy rate of every major central bank in the world, side by side, from the Bank for International Settlements' open statistics (WS_CBPOL): the current rate for ~40 monetary authorities (Fed, ECB, BoE, BoJ and more) ranked in one call; one central bank's policy rate with full history and its latest move; and a global rate-cycle dashboard reporting who has hiked, cut or held with the size of the move. Live, no key, nothing stored; rates are monthly. Distinct from single-central-bank APIs — this is every central bank's policy rate in one place, from the BIS.",
        "central_banks": 48,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T20:24:51.172Z",
        "request_id": "4d085d83-02dc-4dae-8808-7c28a8635204"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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