# Chain TVL API
> Live DeFi total-value-locked per blockchain as an API, streamed from the DefiLlama chains feed. For every chain DefiLlama tracks: the dollar value of assets locked in its DeFi protocols, its native token symbol, and its share of all DeFi value (dominance), plus 7-day and 30-day change for a chain. Rank the blockchains by how much capital they hold, drill into one chain, read the total DeFi market and its leader, or search. The blockchain-level view of where DeFi capital lives. Live, no key. Distinct from protocol-level TVL, fees, DEX-volume and yield APIs — here the entity is the chain, not the protocol.

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

## Pricing
- **Free** (Free) — 240 calls/Mo, 3 req/s
- **Analyst** ($13/Mo) — 8,400 calls/Mo, 10 req/s
- **Pro** ($35/Mo) — 43,000 calls/Mo, 25 req/s
- **Fund** ($82/Mo) — 215,000 calls/Mo, 45 req/s

## Endpoints

### Chains

#### `GET /v1/chain` — One chain TVL + change

**Parameters:**
- `name` (query, required, string) — Chain name Example: `Ethereum`

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

**Response:**
```json
{
    "data": {
        "chain": {
            "name": "Ethereum",
            "rank": 1,
            "tvl_usd": 37525912986,
            "chain_id": 1,
            "gecko_id": "ethereum",
            "token_symbol": "ETH",
            "change_7d_pct": -10.09,
            "dominance_pct": 52,
            "change_30d_pct": -17.64
        }
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:07.223Z",
        "request_id": "ac62a327-6510-494e-8091-bf6b86da830f"
    },
    "status": "ok",
    "message": "Chain retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search chains

**Parameters:**
- `q` (query, required, string) — Search term Example: `arbi`
- `limit` (query, optional, string) — Max 1-100 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/chaintvl-api/v1/search?q=arbi&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 2,
        "query": "arbi",
        "total": 2,
        "chains": [
            {
                "name": "Arbitrum",
                "rank": 9,
                "tvl_usd": 1260234521,
                "chain_id": 42161,
                "gecko_id": "arbitrum",
                "token_symbol": "ARB",
                "dominance_pct": 1.75
            },
            {
                "name": "Arbitrum Nova",
                "rank": 194,
                "tvl_usd": 340157,
                "chain_id": 42170,
                "gecko_id": null,
                "token_symbol": null,
                "dominance_pct": 0
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:07.348Z",
        "request_id": "4a059ac5-2f59-4031-9fff-6e32e029ff23"
    },
    "status": "ok",
    "message": "Search results retrieved successfully",
    "success": true
}
```

#### `GET /v1/top` — Chains ranked by DeFi TVL

**Parameters:**
- `limit` (query, optional, string) — Max 1-300 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/chaintvl-api/v1/top?limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "chains": [
            {
                "name": "Ethereum",
                "rank": 1,
                "tvl_usd": 37525912986,
                "chain_id": 1,
                "gecko_id": "ethereum",
                "token_symbol": "ETH",
                "dominance_pct": 52
            },
            {
                "name": "BSC",
                "rank": 2,
                "tvl_usd": 5172717234,
                "chain_id": 56,
                "gecko_id": "binancecoin",
                "token_symbol": "BNB",
                "dominance_pct": 7.17
            },
            {
                "name": "Solana",
                "rank": 3,
                "tvl_usd": 4899513420,
                "chain_id": null,
                "gecko_id": "solana",
                "token_symbol": "SOL",
                "dominance_pct": 6.79
            },
            {
                "name": "Tron",
                "rank": 4,
                "tvl_usd": 4504779204,
                "chain_id": null,
                "gecko_id": "tron",
                "token_symbol": "TRON",
                "dominance_pct": 6.24
            },
            {
                "name": "Bitcoin",
                "rank": 5,
                "tvl_usd": 4128402238,
                "chain_id": null,
                "gecko_id": "bitcoin",
                "token_symbol": "BTC",
                "dominance_pct": 5.72
            },
            {
                "name": "Base",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/total` — Total DeFi TVL and leader

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

**Response:**
```json
{
    "data": {
        "top_chain": "Ethereum",
        "chains_tracked": 451,
        "total_defi_tvl_usd": 72170722892,
        "top_chain_dominance_pct": 52
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:07.575Z",
        "request_id": "d49ef1d8-c0f4-4088-b612-646a9e81488b"
    },
    "status": "ok",
    "message": "Total TVL retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "source": "DefiLlama chains (live)",
        "service": "chaintvl-api",
        "endpoints": {
            "GET /v1/top": "Chains ranked by DeFi TVL with dominance (limit).",
            "GET /v1/meta": "This document.",
            "GET /v1/chain": "One chain's TVL, rank, dominance and 7d/30d change (name=Ethereum).",
            "GET /v1/total": "Total DeFi TVL across all chains and the leader.",
            "GET /v1/search": "Search chains by name or token (q=)."
        },
        "description": "Live DeFi total-value-locked per blockchain from DefiLlama (v2/chains): each chain's TVL, native token symbol, and share of all DeFi value, plus 7d/30d change per chain. Rank chains by capital held, drill into one, read the market total, or search. Live, no key. Distinct from protocol-level TVL, fees, DEX-volume and yield APIs — the entity is the chain.",
        "chains_tracked": 451,
        "total_defi_tvl_usd": 72170722892
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:07.689Z",
        "request_id": "bf0aa168-23ca-4598-8351-1bc0654cf477"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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