# European Central Bank API
> Live official euro-area monetary data from the ECB Data Portal — no key, nothing cached. This is the money side of the euro, not exchange rates. The key-rates endpoint returns the ECB's three policy interest rates — the deposit facility rate, the main refinancing operations (MRO) rate and the marginal lending facility rate — the rates that set the price of money across the euro area, each with the date it took effect and recent history (deposit facility around 2.00%, MRO 2.15%). The estr endpoint returns €STR, the euro short-term rate, the overnight benchmark that replaced EONIA, with its recent path. The yield-curve endpoint returns the euro-area AAA-rated government bond spot-rate curve across maturities from 3 months to 30 years, with the 10-year-minus-1-year slope. Everything is the ECB's own published series. This is the euro-rates layer for any fixed-income, macro, forex or research app that needs authoritative European central-bank numbers. Live from the ECB, nothing stored. Distinct from exchange-rate APIs and from the Bank of Canada and US-Treasury APIs — this is the ECB's policy rates, €STR and euro yield curve. 4 endpoints.

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

## Pricing
- **Free** (Free) — 12,500 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 148,000 calls/Mo, 8 req/s
- **Pro** ($21/Mo) — 670,000 calls/Mo, 15 req/s
- **Scale** ($50/Mo) — 3,350,000 calls/Mo, 30 req/s

## Endpoints

### Rates

#### `GET /v1/estr` — €STR euro short-term rate

**Parameters:**
- `history` (query, optional, string) — Past values to include (1-60) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ecb-api/v1/estr?history=10"
```

**Response:**
```json
{
    "data": {
        "date": "2026-06-08",
        "name": "€STR (Euro Short-Term Rate)",
        "source": "European Central Bank",
        "history": [
            {
                "date": "2026-05-26",
                "rate_pct": 1.932
            },
            {
                "date": "2026-05-27",
                "rate_pct": 1.932
            },
            {
                "date": "2026-05-28",
                "rate_pct": 1.933
            },
            {
                "date": "2026-05-29",
                "rate_pct": 1.93
            },
            {
                "date": "2026-06-01",
                "rate_pct": 1.931
            },
            {
                "date": "2026-06-02",
                "rate_pct": 1.932
            },
            {
                "date": "2026-06-03",
                "rate_pct": 1.931
            },
            {
                "date": "2026-06-04",
                "rate_pct": 1.933
            },
            {
                "date": "2026-06-05",
                "rate_pct": 1.931
            },
            {
                "date": "2026-06-08",
                "rate_pct": 1.93
            }
        ],
        "rate_pct": 1.93
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:36.731Z",
        "request_id": "32460fa9-e12c-47dc-b21e-ec38c1333376"
    },
    "status": "ok",
    "message": "€STR retrieved successfully",
    "success": true
}
```

#### `GET /v1/key_rates` — ECB policy interest rates

**Parameters:**
- `history` (query, optional, string) — Past values to include (1-20) Example: `3`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ecb-api/v1/key_rates?history=3"
```

**Response:**
```json
{
    "data": {
        "rates": {
            "deposit_facility": {
                "history": [
                    {
                        "date": "2025-03-12",
                        "rate_pct": 2.5
                    },
                    {
                        "date": "2025-04-23",
                        "rate_pct": 2.25
                    },
                    {
                        "date": "2025-06-11",
                        "rate_pct": 2
                    }
                ],
                "rate_pct": 2,
                "effective_date": "2025-06-11"
            },
            "marginal_lending_facility": {
                "history": [
                    {
                        "date": "2025-03-12",
                        "rate_pct": 2.9
                    },
                    {
                        "date": "2025-04-23",
                        "rate_pct": 2.65
                    },
                    {
                        "date": "2025-06-11",
                        "rate_pct": 2.4
                    }
                ],
                "rate_pct": 2.4,
                "effective_date": "2025-06-11"
            },
            "main_refinancing_operations": {
                "history": [
                    {
                        "date": "2025-03-12",
                        "rate_pct": 2.65
                    },
                    {
                        "date": "2025-04-23",
                        "rate_pct": 2.4
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/yield_curve` — Euro-area AAA bond yield curve

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

**Response:**
```json
{
    "data": {
        "date": "2026-06-08",
        "basis": "AAA-rated central government bonds, spot rate",
        "count": 7,
        "curve": [
            {
                "tenor": "3M",
                "months": 3,
                "yield_pct": 2.2654
            },
            {
                "tenor": "6M",
                "months": 6,
                "yield_pct": 2.3824
            },
            {
                "tenor": "1Y",
                "months": 12,
                "yield_pct": 2.5225
            },
            {
                "tenor": "2Y",
                "months": 24,
                "yield_pct": 2.6236
            },
            {
                "tenor": "5Y",
                "months": 60,
                "yield_pct": 2.7495
            },
            {
                "tenor": "10Y",
                "months": 120,
                "yield_pct": 3.0921
            },
            {
                "tenor": "30Y",
                "months": 360,
                "yield_pct": 3.5611
            }
        ],
        "region": "Euro area",
        "source": "European Central Bank",
        "spread_10y_1y_bps": 57
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:44.982Z",
        "request_id": "a6b4b219-b30d-45b9-aa4c-b99deb699b3a"
    },
    "status": "ok",
    "message": "Yield curve retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "ECB Data Portal SDMX API (live)",
        "service": "ecb-api",
        "endpoints": {
            "GET /v1/estr": "€STR euro short-term rate, current + recent history.",
            "GET /v1/meta": "This document.",
            "GET /v1/key_rates": "ECB policy rates: deposit facility, MRO, marginal lending (history=N for past values).",
            "GET /v1/yield_curve": "Euro-area AAA government bond spot yield curve (3M–30Y) + 10y-1y spread."
        },
        "description": "Live official euro-area monetary data from the ECB Data Portal: the ECB's three policy interest rates (deposit facility, main refinancing operations, marginal lending facility) with effective dates and history; €STR, the euro short-term overnight benchmark, with its recent path; and the euro-area AAA government bond spot-rate yield curve from 3 months to 30 years with the 10y-1y slope. Live, no key, nothing stored. Distinct from exchange-rate APIs and from the Bank of Canada and US-Treasury APIs — this is the ECB's policy rates, €STR and euro yield curve.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:45.104Z",
        "request_id": "b4ca9010-37dd-4368-b9c8-28e37de2980f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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