# DEX Volume API
> Live decentralised-exchange trading volume across the whole crypto ecosystem as an API, streamed from the DefiLlama DEX feed. For thousands of DEX protocols: the trading volume over the last 24 hours, 7 days and 30 days, the day/week/month change, the chains they run on, and each one's share of the total DEX market. Rank the busiest DEXes, drill into a single one, see how trading volume is split across chains, or read the market-wide total. Built for crypto, trading and dashboard apps. Live, no key. Distinct from TVL, fees, yield and stablecoin APIs — this is the on-chain trading-activity 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/dexvolume-api/..."
```

## Pricing
- **Free** (Free) — 150 calls/Mo, 3 req/s
- **Trader** ($15/Mo) — 7,500 calls/Mo, 8 req/s
- **Pro** ($38/Mo) — 38,000 calls/Mo, 20 req/s
- **Desk** ($90/Mo) — 190,000 calls/Mo, 40 req/s

## Endpoints

### DEX

#### `GET /v1/chains` — DEX volume per chain

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

**Response:**
```json
{
    "data": {
        "count": 10,
        "chains": [
            {
                "chain": "ethereum",
                "dexes": 140,
                "share_pct": 25.1,
                "volume_24h": 1579745417
            },
            {
                "chain": "solana",
                "dexes": 98,
                "share_pct": 23.57,
                "volume_24h": 1483778552
            },
            {
                "chain": "base",
                "dexes": 145,
                "share_pct": 19.35,
                "volume_24h": 1217629190
            },
            {
                "chain": "bsc",
                "dexes": 157,
                "share_pct": 14.94,
                "volume_24h": 940037097
            },
            {
                "chain": "hyperliquid",
                "dexes": 46,
                "share_pct": 7.78,
                "volume_24h": 489408080
            },
            {
                "chain": "arbitrum",
                "dexes": 136,
                "share_pct": 3.52,
                "volume_24h": 221427059
            },
            {
                "chain": "polygon",
                "dexes": 106,
                "share_pct": 3.16,
                "volume_24h": 199081891
            },
            {
                "chain": "avax",
                "dexes": 86,
                "share_pct": 1.2,
                "volume_24h": 75570467
            },
            {
                "chain": "sui",
                "dexes": 26,
            
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/dex` — One DEX's volume

**Parameters:**
- `name` (query, required, string) — DEX name Example: `Uniswap V3`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexvolume-api/v1/dex?name=Uniswap+V3"
```

**Response:**
```json
{
    "data": {
        "dex": {
            "name": "Uniswap V3",
            "chains": [
                "Ethereum",
                "Arbitrum",
                "OP Mainnet",
                "Polygon",
                "Celo",
                "ZKsync Era",
                "Sei",
                "Taiko",
                "Scroll",
                "Rootstock",
                "Filecoin",
                "Boba",
                "Moonbeam",
                "Manta",
                "Mantle",
                "Linea",
                "BSC",
                "Avalanche",
                "Base",
                "Polygon zkEVM",
                "Blast",
                "Gnosis",
                "BOB",
                "Lisk",
                "Corn",
                "Unichain",
                "Hemi",
                "Saga",
                "LightLink",
                "GOAT",
                "XDC",
                "Lens",
                "Telos",
                "World Chain",
                "Nibiru",
                "Plasma",
                "Monad",
                "Etherlink",
                "Sonic",
                "X Layer",
                "Zora"
            ],
            "category": "Dexs",
            "volume_7d": 6411241021,
            "volume_24h": 680206195,
            "volume_30d": 17164667875,
            "change_1d_pct": 37.89,
            "change_7d_pct": -16.99,
            "dominance_pct": 9.51,
            "change_30d_pct": 218.91
        }
    },
    "meta": {
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/top` — Top DEXes by volume

**Parameters:**
- `sort` (query, optional, string) — 24h | 7d | 30d Example: `24h`
- `chain` (query, optional, string) — Chain filter, e.g. solana
- `category` (query, optional, string) — Category filter
- `limit` (query, optional, string) — Max 1-200 Example: `25`

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

**Response:**
```json
{
    "data": {
        "sort": "24h",
        "chain": "all",
        "count": 25,
        "dexes": [
            {
                "name": "Uniswap V4",
                "chains": [
                    "Ethereum",
                    "OP Mainnet",
                    "Base",
                    "Arbitrum",
                    "Polygon",
                    "Blast",
                    "Zora",
                    "World Chain",
                    "Ink",
                    "Soneium",
                    "Avalanche",
                    "BSC",
                    "Unichain",
                    "Monad",
                    "X Layer"
                ],
                "category": "Dexs",
                "volume_7d": 7498919995,
                "volume_24h": 1011550256,
                "volume_30d": 24606820224,
                "change_1d_pct": 53.55,
                "change_7d_pct": -1.42,
                "dominance_pct": 14.15,
                "change_30d_pct": 57.38
            },
            {
                "name": "PancakeSwap AMM V3",
                "chains": [
                    "BSC",
                    "Ethereum",
                    "Polygon zkEVM",
                    "ZKsync Era",
                    "Arbitrum",
                    "Linea",
                    "Base",
                    "opBNB",
                    "Solana",
                    "Monad"
                ],
                "category": "Dexs",
                "volume_7d": 6237077961,
             
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/total` — Market-wide DEX volume

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

**Response:**
```json
{
    "data": {
        "change_1d_pct": 19.69,
        "change_7d_pct": -15.82,
        "dexes_tracked": 1164,
        "change_30d_pct": 38.1,
        "total_volume_7d": 65053001553,
        "total_volume_24h": 7148795019,
        "total_volume_30d": 205896560754
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:17.885Z",
        "request_id": "261630c6-bf82-40ca-a8e2-ff9b969f11e1"
    },
    "status": "ok",
    "message": "Total volume retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sorts": [
            "24h",
            "7d",
            "30d"
        ],
        "source": "DefiLlama DEX overview (live)",
        "service": "dexvolume-api",
        "endpoints": {
            "GET /v1/dex": "One DEX's volume (name=, e.g. Uniswap V3).",
            "GET /v1/top": "Top DEXes by volume (sort=24h|7d|30d, chain=, category=, limit).",
            "GET /v1/meta": "This document.",
            "GET /v1/total": "Market-wide DEX volume totals and change.",
            "GET /v1/chains": "DEX volume per chain with share."
        },
        "description": "Live decentralised-exchange trading volume from DefiLlama (overview/dexs): 24h/7d/30d volume, change and dominance for thousands of DEX protocols, plus volume split per chain and the market-wide total. Rank the busiest DEXes, drill into one, or see per-chain volume. Live, no key. Distinct from TVL, fees, yield and stablecoin APIs.",
        "dexes_tracked": 1164,
        "chains_covered": [
            "ethereum",
            "bsc",
            "solana",
            "arbitrum",
            "base",
            "polygon",
            "optimism",
            "avax",
            "sui",
            "hyperliquid"
        ],
        "total_volume_24h": 7148795019
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:18.012Z",
        "request_id": "81507d5a-9baf-43a3-82fd-a49c1749ea18"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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