# ether.fi Liquid Restaking API
> Live data for ether.fi, the largest liquid-restaking protocol on Ethereum, read keyless from ether.fi's public APR feed and directly from the Ethereum blockchain. Stake ETH with ether.fi and you get eETH, a rebasing token worth one ETH that earns both Ethereum staking rewards and EigenLayer restaking rewards on top — the "restaking premium" that made liquid restaking the fastest-growing corner of DeFi. weETH is the wrapped, value-accruing version of eETH that most of DeFi actually holds and lends against, and its eETH exchange rate is the number you need to value it. The apr endpoint returns the eETH restaking APR — the latest reading plus the recent daily history and its average. The restaked endpoint reads the chain directly: the total ETH restaked through ether.fi (the eETH supply, which rebases to track ETH one-for-one) and its US-dollar value, plus how much of it is wrapped into weETH versus held as eETH. The weeth endpoint is the wrapped-token view: the weETH supply and its on-chain rate — how much eETH (and therefore ETH and USD) one weETH is worth right now, the figure lending markets use to price weETH collateral. This is the ether.fi liquid-restaking cut — distinct from the synthetic-dollar protocol feed, the generic staking and yield-aggregator feeds and the generic token-info feed: it is the single-protocol view of the biggest restaking token, its yield, its size and its wrapped-token rate. APR is an annualised percentage; amounts are in ETH and USD; the rate is eETH per weETH (above 1.0, rising as yield accrues). No key, nothing stored beyond a short cache.

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

## Pricing
- **Free** (Free) — 1,050 calls/Mo, 2 req/s
- **Starter** ($22/Mo) — 23,500 calls/Mo, 6 req/s
- **Pro** ($66/Mo) — 134,000 calls/Mo, 16 req/s
- **Scale** ($197/Mo) — 510,000 calls/Mo, 40 req/s

## Endpoints

### APR

#### `GET /v1/apr` — eETH restaking APR — latest, 7-day average and history

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

**Response:**
```json
{
    "data": {
        "days": 7,
        "note": "ether.fi's eETH restaking APR — the latest reading, the average of the recent daily readings, and the daily history (most recent last). The yield combines Ethereum staking rewards with EigenLayer restaking rewards (the restaking premium), so it moves with both staking participation and restaking demand. Annualised percent. Live, cached ~5m.",
        "source": "ether.fi public APR API (etherfi.bid), keyless",
        "apr_pct": 2.69,
        "history_pct": [
            2.4,
            2.4,
            2.46,
            2.5,
            2.5,
            2.63,
            2.69
        ],
        "apr_7d_avg_pct": 2.511
    },
    "meta": {
        "timestamp": "2026-06-12T19:35:38.520Z",
        "request_id": "ab6ad362-d966-4c33-b72d-cafd130ad195"
    },
    "status": "ok",
    "message": "APR retrieved successfully",
    "success": true
}
```

### Restaked

#### `GET /v1/restaked` — Total ETH restaked (eETH supply) and its USD value

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

**Response:**
```json
{
    "data": {
        "note": "The total ETH restaked through ether.fi, read straight from the chain. total_eth_restaked is the eETH supply — eETH is a rebasing token that tracks ETH one-for-one, so its supply equals the ETH restaked — and total_value_usd prices that at the live ETH price. weeth_supply is how much of it has been wrapped into the value-accruing weETH (the rest is held as eETH). Amounts in ETH and USD. Live, cached ~5m.",
        "source": "Ethereum public JSON-RPC (eETH contract) + Yahoo Finance, keyless",
        "weeth_supply": 1552107.4,
        "eth_price_usd": 1664.43,
        "eeth_unwrapped": 294041.7,
        "total_value_usd": 3072785948,
        "total_eth_restaked": 1846149.1
    },
    "meta": {
        "timestamp": "2026-06-12T19:35:38.704Z",
        "request_id": "1e3cb564-941a-4ce6-8a5a-0c04c799e13c"
    },
    "status": "ok",
    "message": "Restaked retrieved successfully",
    "success": true
}
```

### weETH

#### `GET /v1/weeth` — weETH wrapped-token supply and its eETH/ETH/USD rate

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

**Response:**
```json
{
    "data": {
        "note": "The wrapped weETH token. weETH is the non-rebasing, value-accruing wrapper of eETH that most of DeFi holds and lends against; eeth_per_weeth (read on-chain via getRate) is how much eETH — and therefore ETH — one weETH is now worth. It rises over time as restaking yield accrues, which is why it is above 1.0. weeth_value_usd prices one weETH at the live ETH price — the figure lending markets use to value weETH collateral. Live, cached ~5m.",
        "source": "Ethereum public JSON-RPC (weETH contract) + Yahoo Finance, keyless",
        "weeth_supply": 1552107.4,
        "eth_price_usd": 1664.43,
        "eeth_per_weeth": 1.09690413,
        "weeth_value_eth": 1.09690413,
        "weeth_value_usd": 1825.72
    },
    "meta": {
        "timestamp": "2026-06-12T19:35:38.966Z",
        "request_id": "73bcf63e-21d6-4bfb-8275-1f384b0c1b26"
    },
    "status": "ok",
    "message": "weETH retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "All endpoints take no parameters. APR is an annualised percent; total ETH restaked is the eETH supply (rebasing, = ETH); weETH rate is eETH per weETH (above 1.0, rising as yield accrues); USD uses the live ETH price. A ~5-minute cache fronts the upstreams.",
        "source": "ether.fi public APR API + Ethereum public JSON-RPC + Yahoo Finance, keyless, live",
        "service": "etherfi-api",
        "endpoints": {
            "GET /v1/apr": "eETH restaking APR — latest, 7-day average and history.",
            "GET /v1/meta": "This document.",
            "GET /v1/weeth": "weETH wrapped-token supply and its eETH/ETH/USD rate.",
            "GET /v1/restaked": "Total ETH restaked (eETH supply) and its USD value."
        },
        "sample_apr": {
            "apr_pct": 2.69
        },
        "description": "Live data for ether.fi, the largest liquid-restaking protocol on Ethereum, keyless from ether.fi's public APR feed and directly from the chain. eETH is a rebasing token worth one ETH that earns Ethereum staking plus EigenLayer restaking rewards; weETH is its wrapped, value-accruing version that DeFi lends against. The apr endpoint gives the eETH restaking APR (latest, 7-day average, history); restaked reads the chain for the total ETH restaked (eETH supply) and its USD value; weeth gives the wrapped token's supply and its on-chain eETH/ETH rate. The ether.fi liquid-restaking cut — distinct from the synthetic-dollar protocol feed, the 
…(truncated, see openapi.json for full schema)
```


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