# Blockchair Multi-Chain Stats API
> Live on-chain network statistics, mempool conditions and market data across the major UTXO blockchains and Ethereum, sourced from Blockchair. For any supported chain read the full network state — best block height, total and 24-hour block and transaction counts, mining difficulty, hashrate, coin circulation, on-chain transfer volume and chain size — or zoom into the mempool to see pending transactions, mempool size, transactions-per-second, the suggested fee per byte (or median gas price on Ethereum) and average and median transaction fees in native units and USD, or pull market data with the coin price in USD and BTC, 24-hour change, market capitalisation and dominance. Ten chains are covered: Bitcoin, Bitcoin Cash, Litecoin, Dogecoin, Dash, Zcash, Bitcoin SV, eCash, Groestlcoin and Ethereum. Distinct from single-chain mempool and gas feeds: this is one consistent multi-chain stats surface.

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

## Pricing
- **Free** (Free) — 1,880 calls/Mo, 2 req/s
- **Basic** ($10/Mo) — 47,200 calls/Mo, 6 req/s
- **Pro** ($32/Mo) — 198,000 calls/Mo, 18 req/s
- **Scale** ($73/Mo) — 845,000 calls/Mo, 45 req/s

## Endpoints

### Reference

#### `GET /v1/chains` — List supported chains

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

**Response:**
```json
{
    "data": {
        "count": 10,
        "chains": [
            {
                "name": "Bitcoin",
                "chain": "bitcoin"
            },
            {
                "name": "Bitcoin Cash",
                "chain": "bitcoin-cash"
            },
            {
                "name": "Litecoin",
                "chain": "litecoin"
            },
            {
                "name": "Dogecoin",
                "chain": "dogecoin"
            },
            {
                "name": "Dash",
                "chain": "dash"
            },
            {
                "name": "Zcash",
                "chain": "zcash"
            },
            {
                "name": "Bitcoin SV",
                "chain": "bitcoin-sv"
            },
            {
                "name": "eCash",
                "chain": "ecash"
            },
            {
                "name": "Groestlcoin",
                "chain": "groestlcoin"
            },
            {
                "name": "Ethereum",
                "chain": "ethereum"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:27.313Z",
        "request_id": "a44ff4e9-34ff-4c39-b616-fc1eba84938c"
    },
    "status": "ok",
    "message": "Chains retrieved successfully",
    "success": true
}
```

### Stats

#### `GET /v1/stats` — Network stats for a chain

**Parameters:**
- `chain` (query, optional, string) — Chain slug (default bitcoin) Example: `bitcoin`

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

**Response:**
```json
{
    "data": {
        "name": "Bitcoin",
        "chain": "bitcoin",
        "nodes": 344,
        "blocks": 953775,
        "blocks_24h": 151,
        "difficulty": 124932866006548.2,
        "volume_24h": "55310721576504",
        "circulation": "2004301791997096",
        "hashrate_24h": "938081422541387730514",
        "transactions": 1376900853,
        "inflation_24h": 47187500000,
        "best_block_hash": "0000000000000000000025ae8bd3797aedd6cbd4a8f6346e32dbcb6cfe511cc8",
        "best_block_time": "2026-06-15 11:03:23",
        "blockchain_size": 747521111736,
        "transactions_24h": 756343,
        "best_block_height": 953774
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:27.557Z",
        "request_id": "c3a1ae63-748b-4f2d-ad72-55d75838a919"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Mempool

#### `GET /v1/mempool` — Mempool and fee conditions for a chain

**Parameters:**
- `chain` (query, optional, string) — Chain slug (default bitcoin) Example: `bitcoin`

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

**Response:**
```json
{
    "data": {
        "name": "Bitcoin",
        "chain": "bitcoin",
        "mempool_tps": 4.35,
        "mempool_size": 92649533,
        "mempool_transactions": 110287,
        "mempool_total_fee_usd": 7590.2358,
        "mempool_median_gas_price": null,
        "median_transaction_fee_24h": 88,
        "suggested_fee_per_byte_sat": 2,
        "average_transaction_fee_24h": 363,
        "median_transaction_fee_usd_24h": 0.05800608,
        "average_transaction_fee_usd_24h": 0.23983344471405166
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:27.669Z",
        "request_id": "3bd1fd4e-f13a-4cc5-ba52-6b0fcf5bc3f5"
    },
    "status": "ok",
    "message": "Mempool retrieved successfully",
    "success": true
}
```

### Market

#### `GET /v1/market` — Market price, cap and dominance for a chain

**Parameters:**
- `chain` (query, optional, string) — Chain slug (default bitcoin) Example: `ethereum`

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

**Response:**
```json
{
    "data": {
        "name": "Ethereum",
        "chain": "ethereum",
        "price_btc": 0.026387528244946,
        "price_usd": 1740.02,
        "market_cap_usd": 209699523103,
        "market_dominance_percentage": 8.94,
        "price_change_24h_percentage": 3.99061
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:27.803Z",
        "request_id": "785d21b1-cb75-4c2f-823e-58e14e3d25aa"
    },
    "status": "ok",
    "message": "Market data retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "name": "Blockchair Multi-Chain Stats API",
        "source": "Blockchair (api.blockchair.com)",
        "endpoints": [
            {
                "path": "/v1/chains",
                "description": "List supported chains"
            },
            {
                "path": "/v1/stats",
                "description": "Network stats for a chain (?chain=bitcoin)"
            },
            {
                "path": "/v1/mempool",
                "description": "Mempool and fee conditions for a chain (?chain=bitcoin)"
            },
            {
                "path": "/v1/market",
                "description": "Market price, cap and dominance for a chain (?chain=bitcoin)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "cache_note": "Responses are cached ~60s per chain to respect the upstream public rate limit; on-chain stats update per block.",
        "disclaimer": "Unofficial proxy of the public Blockchair stats endpoints. Not affiliated with Blockchair. Data only; no guarantees of accuracy or availability.",
        "description": "On-chain network statistics, mempool/fee conditions and market data across major UTXO chains and Ethereum, sourced from Blockchair.",
        "supported_chains": [
            "bitcoin",
            "bitcoin-cash",
            "litecoin",
            "dogecoin",
            "dash",
            "zcash",
        
…(truncated, see openapi.json for full schema)
```


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