# Ethereum Supply & Burn API
> Live Ethereum monetary-policy data — the total ETH supply, how much of it is being created versus destroyed, and the EIP-1559 fee burn that can make ether deflationary (the "ultrasound money" thesis), powered by the public ultrasound.money feed, no key, nothing stored. The supply endpoint returns the current circulating ETH supply and its net change over the last 5 minutes, hour, day, week and month — a negative change means more ETH was burned than issued, i.e. net deflation. The burn endpoint returns the ETH destroyed by the base-fee burn over each window in both ETH and USD, the live burn rate in ETH per minute and the current deflationary streak. The basefee endpoint returns the current base fee per gas, the blob base fee and the ETH price. The leaderboard endpoint ranks the apps and contracts burning the most ETH right now. Track ETH issuance, the burn and whether ether is deflating as live JSON. This is the ETH supply / issuance / burn cut — distinct from the gas-fee, on-chain and price 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/ethburn-api/..."
```

## Pricing
- **Free** (Free) — 19,000 calls/Mo, 3 req/s
- **Analyst** ($8/Mo) — 205,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 890,000 calls/Mo, 28 req/s
- **Scale** ($55/Mo) — 3,050,000 calls/Mo, 65 req/s

## Endpoints

### Supply

#### `GET /v1/supply` — ETH supply and net change over windows

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

**Response:**
```json
{
    "data": {
        "note": "net_change_eth is issuance minus burn over the window; negative means net deflation (more ETH burned than created).",
        "chain": "Ethereum",
        "source": "ultrasound.money",
        "block_number": 25295502,
        "net_change_eth": {
            "d1": 2783.4,
            "d7": 19175.05,
            "h1": 109.9088,
            "m5": 11.897,
            "d30": 82439.69
        },
        "current_supply_eth": 121771358.57
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:43.185Z",
        "request_id": "542d10ca-2ff7-43d3-9c52-1d5917ac7d2b"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Burn

#### `GET /v1/burn` — ETH burned per window, rate, deflation

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

**Response:**
```json
{
    "data": {
        "chain": "Ethereum",
        "source": "ultrasound.money",
        "burned_eth": {
            "d7": 539.4272,
            "h1": 3.9726,
            "m5": 0.2299,
            "all": 4634878,
            "d30": 1960,
            "h24": 42.2576,
            "since_merge": 2011568
        },
        "burned_usd": {
            "d7": 881181,
            "h1": 6529.17,
            "m5": 377.53,
            "d30": 3833722,
            "h24": 69285,
            "since_merge": 4548047208
        },
        "deflationary_streak": {
            "preMerge": null,
            "postMerge": null
        },
        "burn_rate_eth_per_min": {
            "d7": 0.05351,
            "h1": 0.06621,
            "m5": 0.04599,
            "d30": 0.04536,
            "h24": 0.02935
        }
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:43.352Z",
        "request_id": "b7cf4577-3d25-424e-88e7-eda71256960f"
    },
    "status": "ok",
    "message": "Burn retrieved successfully",
    "success": true
}
```

### BaseFee

#### `GET /v1/basefee` — Base fee per gas, blob fee, ETH price

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

**Response:**
```json
{
    "data": {
        "chain": "Ethereum",
        "source": "ultrasound.money",
        "base_fee_gwei": 0.3442,
        "eth_price_usd": 1639.67,
        "blob_base_fee_gwei": 0.016535,
        "eth_price_24h_change_pct": -0.12
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:43.458Z",
        "request_id": "7882c7d0-c25e-4e6c-8db8-e9d94b095acf"
    },
    "status": "ok",
    "message": "Base fee retrieved successfully",
    "success": true
}
```

### Leaderboard

#### `GET /v1/leaderboard` — Top ETH-burning apps and contracts

**Parameters:**
- `period` (query, optional, string) — 5m, 1h, 24h, 7d, 30d, all, since_merge Example: `24h`
- `limit` (query, optional, string) — Max rows (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ethburn-api/v1/leaderboard?period=24h&limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "Apps and contracts that burned the most ETH (base fee) over the period.",
        "count": 25,
        "period": "24h",
        "source": "ultrasound.money",
        "leaderboard": [
            {
                "id": "eth-transfers",
                "name": "ETH transfers",
                "rank": 1,
                "type": "eth-transfers",
                "burned_eth": 2.9603,
                "burned_usd": 4857.22
            },
            {
                "id": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "name": "Tether: USDT Stablecoin",
                "rank": 2,
                "type": "contract",
                "burned_eth": 2.9004,
                "burned_usd": 4759.69
            },
            {
                "id": "0x00fe78205f5f0e63b8ad2b2ae5337f538a610e04",
                "name": null,
                "rank": 3,
                "type": "contract",
                "burned_eth": 2.0074,
                "burned_usd": 3292.87
            },
            {
                "id": "contract-creations",
                "name": "new contracts",
                "rank": 4,
                "type": "contract-creations",
                "burned_eth": 1.8336,
                "burned_usd": 2993.1
            },
            {
                "id": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
                "name": "Circle: USDC Token",
                "rank": 5,
                "type": "contract",
                "burned_e
…(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/ethburn-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "On-chain amounts are wei (1 ETH = 1e18 wei) converted to ETH; gas fees converted to Gwei. leaderboard period: 5m, 1h, 24h, 7d, 30d, all, since_merge.",
        "source": "ultrasound.money (ultrasound.money/api, live)",
        "service": "ethburn-api",
        "endpoints": {
            "GET /v1/burn": "ETH burned per window (ETH + USD), burn rate in ETH/min, deflationary streak.",
            "GET /v1/meta": "This document.",
            "GET /v1/supply": "Current ETH supply and net change over 5m/1h/1d/7d/30d (negative = deflation).",
            "GET /v1/basefee": "Current base fee per gas (Gwei), blob base fee and ETH price.",
            "GET /v1/leaderboard": "Apps/contracts burning the most ETH (period=24h, limit=25)."
        },
        "eth_supply": 121771358.57,
        "description": "Live Ethereum monetary-policy data: total ETH supply, net issuance versus the EIP-1559 fee burn that can make ether deflationary ('ultrasound money'), from ultrasound.money. The supply endpoint returns current ETH supply and its net change over 5m/1h/1d/7d/30d (negative = net deflation); the burn endpoint returns ETH destroyed by the base-fee burn per window in ETH and USD, the burn rate in ETH/min and the deflationary streak; the basefee endpoint returns the current base fee per gas, blob base fee and ETH price; the leaderboard endpoint ranks the apps and contracts burning the most ETH. Live, no key, nothing stored. The ETH supply / issuance / burn cu
…(truncated, see openapi.json for full schema)
```


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