# Chain Stats API
> Live blockchain network statistics across 18 chains, from the public Blockchair feed. Get one network's full stats — price, market cap and dominance, block height, 24h transactions, circulating supply, difficulty, hashrate, mempool size and average fee; compare the major chains side by side, ranked by market cap; and read a chain's mempool congestion (pending transactions, size and fees). A multi-chain network-stats layer — distinct from single-coin price feeds and Bitcoin-only on-chain APIs: it answers how each blockchain is performing right now and how they compare. Live, with a 10-minute upstream 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/chainstats-api/..."
```

## Pricing
- **Free** (Free) — 3,650 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 82,000 calls/Mo, 6 req/s
- **Pro** ($21/Mo) — 430,000 calls/Mo, 15 req/s
- **Business** ($51/Mo) — 2,630,000 calls/Mo, 40 req/s

## Endpoints

### Chain Stats

#### `GET /v1/chain` — One network full stats

**Parameters:**
- `chain` (query, required, string) — Chain id (bitcoin) or ticker alias (btc, eth, ltc) Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/chainstats-api/v1/chain?chain=bitcoin"
```

**Response:**
```json
{
    "data": {
        "chain": "bitcoin",
        "nodes": 356,
        "blocks": 953157,
        "source": "Blockchair",
        "price_usd": 61384,
        "difficulty": 138955357012247.3,
        "circulation": 2004108666997096,
        "hashrate_24h": "884161057735711313294",
        "market_cap_usd": 1230488358299,
        "best_block_time": "2026-06-10 22:43:44",
        "transactions_24h": 583978,
        "best_block_height": 953156,
        "transactions_total": 1374022221,
        "market_dominance_pct": 55.8,
        "mempool_transactions": 75488,
        "price_change_24h_pct": -0.4865,
        "blockchain_size_bytes": 746534641183,
        "mempool_total_fee_usd": 5700.0542,
        "average_transaction_fee_usd_24h": 0.31120228183034293
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:11.587Z",
        "request_id": "ee5232ce-c5f3-47e6-8d72-3aa090c40d07"
    },
    "status": "ok",
    "message": "Chain stats retrieved successfully",
    "success": true
}
```

#### `GET /v1/chains` — Major chains compared, ranked by market cap

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

**Response:**
```json
{
    "data": {
        "count": 6,
        "chains": [
            {
                "chain": "bitcoin",
                "blocks": 953157,
                "price_usd": 61384,
                "market_cap_usd": 1230488358299,
                "transactions_24h": 583978,
                "market_dominance_pct": 55.8,
                "price_change_24h_pct": -0.4865
            },
            {
                "chain": "ethereum",
                "blocks": 25291071,
                "price_usd": 1617.34,
                "market_cap_usd": 195231398535,
                "transactions_24h": 2048204,
                "market_dominance_pct": 8.85,
                "price_change_24h_pct": -1.407
            },
            {
                "chain": "dogecoin",
                "blocks": 6385576,
                "price_usd": 0.082371,
                "market_cap_usd": 12737332128,
                "transactions_24h": 22876,
                "market_dominance_pct": 0.58,
                "price_change_24h_pct": -2.88166
            },
            {
                "chain": "monero",
                "blocks": 3693543,
                "price_usd": 334.69,
                "market_cap_usd": 6296192889,
                "transactions_24h": null,
                "market_dominance_pct": 0.29,
                "price_change_24h_pct": 8.72126
            },
            {
                "chain": "bitcoin-cash",
                "blocks": 954784,
                "price_usd": 193.39,
                "market_cap
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/mempool` — A chain mempool congestion

**Parameters:**
- `chain` (query, required, string) — Chain id or ticker alias Example: `bitcoin`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/chainstats-api/v1/mempool?chain=bitcoin"
```

**Response:**
```json
{
    "data": {
        "note": null,
        "chain": "bitcoin",
        "source": "Blockchair",
        "mempool_tps": 5.55,
        "mempool_size_bytes": 74973996,
        "mempool_transactions": 75488,
        "mempool_total_fee_usd": 5700.0542,
        "suggested_fee_per_byte_sat": 2,
        "average_transaction_fee_usd_24h": 0.31120228183034293
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:11.914Z",
        "request_id": "efc4df7d-0fbe-44a8-bfaf-a0eb261f751c"
    },
    "status": "ok",
    "message": "Mempool retrieved successfully",
    "success": true
}
```

#### `GET /v1/meta` — Service metadata and endpoint list

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

**Response:**
```json
{
    "data": {
        "source": "Blockchair API (api.blockchair.com, live)",
        "service": "chainstats-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/chain": "One network's full stats (chain=bitcoin; tickers like btc/eth/ltc are aliased).",
            "GET /v1/chains": "Major chains compared, ranked by market cap.",
            "GET /v1/mempool": "A chain's mempool congestion (chain=bitcoin)."
        },
        "description": "Live blockchain network statistics across 18 chains, from the public Blockchair feed. The chain endpoint returns one network's full stats (price, market cap and dominance, block height, 24h transactions, circulating supply, difficulty, hashrate, mempool size and average fee); the chains endpoint compares the major chains ranked by market cap; the mempool endpoint returns a chain's mempool congestion. A multi-chain network-stats layer, distinct from single-coin price feeds and Bitcoin-only on-chain APIs. Live, with a 10-minute upstream cache.",
        "upstream_status": "ok",
        "supported_chains": [
            "bitcoin",
            "ethereum",
            "litecoin",
            "bitcoin-cash",
            "dogecoin",
            "dash",
            "zcash",
            "monero",
            "groestlcoin",
            "bitcoin-sv",
            "ecash",
            "ripple",
            "stellar",
            "cardano",
            "polkadot",
            "kusama",
            "tezos",
   
…(truncated, see openapi.json for full schema)
```


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