# Crypto Volume API
> Live most-traded crypto pairs by 24-hour spot volume as an API, powered by Binance. It ranks the trading pairs by their 24-hour quote volume — where the real liquidity and activity is right now — with each pair's last price, daily change, 24-hour high and low, base and quote volume, and the number of trades. Rank by any quote currency (USDT, BTC, ETH, USDC), or look a single pair up for its full 24-hour stats. The spot-volume and market-activity leaderboard for trading, screening and dashboard apps. Live, no key, no cache. Distinct from price-change movers and from DEX-volume APIs — this is centralised-exchange spot trading volume.

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

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 5 req/s
- **Starter** ($14/Mo) — 110,000 calls/Mo, 15 req/s
- **Pro** ($37/Mo) — 540,000 calls/Mo, 40 req/s
- **Desk** ($87/Mo) — 2,800,000 calls/Mo, 100 req/s

## Endpoints

### Top

#### `GET /v1/top` — Most-traded pairs by 24h volume

**Parameters:**
- `quote` (query, optional, string) — Quote currency: USDT|BTC|ETH|USDC|FDUSD Example: `USDT`
- `limit` (query, optional, string) — Max pairs (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptovolume-api/v1/top?quote=USDT&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "pairs": [
            {
                "base": "USDC",
                "rank": 1,
                "quote": "USDT",
                "symbol": "USDCUSDT",
                "low_24h": 1.00001,
                "high_24h": 1.0007,
                "change_pct": 0,
                "last_price": 1.00013,
                "trades_24h": 578094,
                "volume_24h_base": 1657380484,
                "volume_24h_quote": 1657826696.61487
            },
            {
                "base": "BTC",
                "rank": 2,
                "quote": "USDT",
                "symbol": "BTCUSDT",
                "low_24h": 62408,
                "high_24h": 64200,
                "change_pct": -0.39,
                "last_price": 62865.46,
                "trades_24h": 4671316,
                "volume_24h_base": 23159.81193,
                "volume_24h_quote": 1467594928.7537253
            },
            {
                "base": "ETH",
                "rank": 3,
                "quote": "USDT",
                "symbol": "ETHUSDT",
                "low_24h": 1645,
                "high_24h": 1714.5,
                "change_pct": -0.97,
                "last_price": 1666.93,
                "trades_24h": 5580137,
                "volume_24h_base": 472929.5716,
                "volume_24h_quote": 794835595.003867
            },
            {
                "base": "ZEC",
                "rank": 4,
                "quote": "USDT",
           
…(truncated, see openapi.json for full schema)
```

### Pair

#### `GET /v1/pair` — A single pair 24h stats

**Parameters:**
- `symbol` (query, required, string) — Trading pair Example: `BTCUSDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptovolume-api/v1/pair?symbol=BTCUSDT"
```

**Response:**
```json
{
    "data": {
        "base": "BTC",
        "quote": "USDT",
        "symbol": "BTCUSDT",
        "low_24h": 62408,
        "high_24h": 64200,
        "change_pct": -0.39,
        "last_price": 62865.46,
        "trades_24h": 4671315,
        "volume_24h_base": 23159.81415,
        "volume_24h_quote": 1467595068.1055183
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:04.312Z",
        "request_id": "07e4ac6d-9940-4dfe-babd-6841fea298c9"
    },
    "status": "ok",
    "message": "Pair retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "quotes": [
            "USDT",
            "BTC",
            "ETH",
            "USDC",
            "FDUSD"
        ],
        "source": "Binance v3 24h ticker (live)",
        "service": "cryptovolume-api",
        "endpoints": {
            "GET /v1/top": "Most-traded pairs by 24h volume (quote=USDT|BTC|ETH|USDC, limit).",
            "GET /v1/meta": "This document.",
            "GET /v1/pair": "A single pair's 24h stats (symbol=BTCUSDT)."
        },
        "usdt_pairs": 664,
        "description": "Live most-traded crypto pairs by 24h spot volume on Binance: pairs ranked by 24h quote volume (where the liquidity is) with last price, daily change, 24h high/low, base and quote volume and trade count. Rank by quote currency (USDT/BTC/ETH/USDC) or look one pair up. Live, no key. Distinct from price-change movers and DEX-volume APIs — this is centralised-exchange spot trading volume."
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:04.711Z",
        "request_id": "ce40c1d6-ad83-46d1-b45d-01e43cbeba39"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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