# Euro Short-Term Rate (€STR) API
> Live euro short-term rate (€STR) data from the European Central Bank. The €STR is the euro area's overnight risk-free benchmark, computed daily by the ECB from the real unsecured borrowing of euro-area banks; it underpins euro derivatives and floating-rate contracts and is the successor to EONIA and a key reference alongside EURIBOR. The estr endpoint returns the latest rate plus its full daily statistics — the underlying borrowing volume, the number of reporting banks and transactions, the 25th and 75th rate percentiles and the share of the five largest banks. The policy endpoint returns the ECB key-rate corridor (deposit facility, main refinancing operations, marginal lending) and where €STR sits inside it. The history endpoint returns the €STR rate over recent days. Read live from the ECB, nothing stored. This is the euro overnight risk-free rate and ECB policy corridor — distinct from FX reference feeds, bond yield curves and money-market futures.

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

## Pricing
- **Free** (Free) — 3,500 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 90,000 calls/Mo, 10 req/s
- **Pro** ($19/Mo) — 440,000 calls/Mo, 30 req/s
- **Scale** ($45/Mo) — 2,700,000 calls/Mo, 100 req/s

## Endpoints

### Rate

#### `GET /v1/estr` — Latest €STR rate plus full daily statistics

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

**Response:**
```json
{
    "data": {
        "date": "2026-06-09",
        "name": "Euro Short-Term Rate",
        "source": "European Central Bank",
        "rate_pct": 1.93,
        "benchmark": "€STR",
        "rate_25th_pct": 1.91,
        "rate_75th_pct": 1.95,
        "number_of_banks": 45,
        "volume_eur_millions": 66032,
        "number_of_transactions": 925,
        "largest_5_banks_share_pct": 41
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:01.349Z",
        "request_id": "0ae5cc34-bb02-45de-aef1-7f3ac37696e5"
    },
    "status": "ok",
    "message": "Rate retrieved successfully",
    "success": true
}
```

### Policy

#### `GET /v1/policy` — ECB key-rate corridor and €STR position

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

**Response:**
```json
{
    "data": {
        "date": "2025-06-11",
        "source": "European Central Bank",
        "estr_pct": 1.93,
        "central_bank": "European Central Bank",
        "corridor_width_bps": 40,
        "deposit_facility_pct": 2,
        "main_refinancing_pct": 2.15,
        "marginal_lending_pct": 2.4,
        "estr_spread_to_deposit_bps": -7
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:02.620Z",
        "request_id": "47fc17c8-8ab9-4ee7-a254-599fcaeaf170"
    },
    "status": "ok",
    "message": "Policy rates retrieved successfully",
    "success": true
}
```

### History

#### `GET /v1/history` — €STR rate over recent days

**Parameters:**
- `days` (query, optional, string) — Number of days (1-365) Example: `30`

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

**Response:**
```json
{
    "data": {
        "count": 30,
        "source": "European Central Bank",
        "history": [
            {
                "date": "2026-04-28",
                "rate_pct": 1.932
            },
            {
                "date": "2026-04-29",
                "rate_pct": 1.932
            },
            {
                "date": "2026-04-30",
                "rate_pct": 1.93
            },
            {
                "date": "2026-05-04",
                "rate_pct": 1.932
            },
            {
                "date": "2026-05-05",
                "rate_pct": 1.932
            },
            {
                "date": "2026-05-06",
                "rate_pct": 1.931
            },
            {
                "date": "2026-05-07",
                "rate_pct": 1.93
            },
            {
                "date": "2026-05-08",
                "rate_pct": 1.929
            },
            {
                "date": "2026-05-11",
                "rate_pct": 1.931
            },
            {
                "date": "2026-05-12",
                "rate_pct": 1.929
            },
            {
                "date": "2026-05-13",
                "rate_pct": 1.928
            },
            {
                "date": "2026-05-14",
                "rate_pct": 1.93
            },
            {
                "date": "2026-05-15",
                "rate_pct": 1.931
            },
            {
                "date": "2026-05-18",
                "rate_pct": 1.931
   
…(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/estr-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "ECB Data Portal (data-api.ecb.europa.eu, live)",
        "service": "estr-api",
        "estr_pct": 1.93,
        "endpoints": {
            "GET /v1/estr": "Latest €STR rate plus full daily statistics (volume, banks, trades, percentiles, concentration).",
            "GET /v1/meta": "This document.",
            "GET /v1/policy": "ECB key-rate corridor (deposit, main refi, marginal lending) and €STR position.",
            "GET /v1/history": "€STR rate over recent days (days=30, max 365)."
        },
        "estr_date": "2026-06-09",
        "description": "Live euro short-term rate (€STR) data from the European Central Bank. The €STR is the euro area's overnight risk-free benchmark, computed daily by the ECB from real unsecured borrowing of euro-area banks; it underpins euro derivatives and floating-rate contracts (the EURIBOR successor). The estr endpoint returns the latest rate plus its full daily statistics — underlying volume, number of reporting banks and trades, 25th/75th rate percentiles and top-5 bank concentration; the policy endpoint returns the ECB key-rate corridor (deposit facility, main refinancing, marginal lending) and where €STR sits inside it; the history endpoint returns the €STR rate over recent days. Live, no key, nothing stored. Distinct from FX reference feeds, bond yield curves and money-market futures — this is the euro overnight risk-free rate and ECB policy corridor.",
        "upstream_status"
…(truncated, see openapi.json for full schema)
```


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