# DEX Aggregators API
> Live trading volume routed through DeFi DEX aggregators — Jupiter, 1inch, CowSwap, Paraswap, OKX Swap, KyberSwap and more — powered by the public DeFiLlama aggregators feed, no key, nothing stored. Aggregators don't hold liquidity themselves: they split each trade across many underlying decentralized exchanges to get the best price, so their volume is the single best measure of where real swap flow actually routes. The overview endpoint returns total aggregator volume over the last 24 hours, 7 days and 30 days plus every aggregator ranked by what it routes, with its category and the chains it covers. The aggregator endpoint returns a single aggregator's volume across 24h / 7d / 30d / all-time. The chain endpoint returns aggregator volume and the top routers for one blockchain (Solana, Ethereum, Base). See which router dominates each chain and how swap flow shifts. This is the swap-routing / aggregator-volume cut of DeFi — distinct from the spot-DEX-volume, fees-and-revenue, TVL and exchange-ticker APIs in the catalogue.

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

## Pricing
- **Free** (Free) — 14,000 calls/Mo, 3 req/s
- **Trader** ($9/Mo) — 185,000 calls/Mo, 10 req/s
- **Pro** ($27/Mo) — 810,000 calls/Mo, 28 req/s
- **Scale** ($61/Mo) — 2,850,000 calls/Mo, 65 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Total aggregator volume + ranked aggregators

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

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

**Response:**
```json
{
    "data": {
        "note": "Volume (USD) routed through DEX aggregators; they split trades across underlying DEXes for best execution.",
        "source": "DeFiLlama",
        "total_d7": 22019715569,
        "total_d30": 66359941120,
        "total_h24": 2418138859,
        "aggregators": [
            {
                "d7": 7882975448,
                "y1": 324864311879,
                "d30": 17060074338,
                "h24": 934626919,
                "name": "Jupiter Aggregator",
                "chains": [
                    "Solana"
                ],
                "category": "DEX Aggregator"
            },
            {
                "d7": 1561789473,
                "y1": 104591851706,
                "d30": 5801933981,
                "h24": 217388901,
                "name": "OKX Swap",
                "chains": [
                    "Ethereum",
                    "BSC",
                    "OKTChain",
                    "Polygon",
                    "Tron",
                    "Avalanche",
                    "Fantom",
                    "Arbitrum",
                    "OP Mainnet",
                    "Cronos",
                    "Solana",
                    "Osmosis",
                    "Aptos",
                    "ZKsync Era",
                    "Conflux",
                    "Sui",
                    "Polygon zkEVM",
                    "Sei",
                    "Linea",
                    "Mantle",
                    "Base",
       
…(truncated, see openapi.json for full schema)
```

### Aggregator

#### `GET /v1/aggregator` — One aggregator volume 24h/7d/30d/all-time

**Parameters:**
- `aggregator` (query, required, string) — DeFiLlama aggregator slug Example: `jupiter-aggregator`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexaggregators-api/v1/aggregator?aggregator=jupiter-aggregator"
```

**Response:**
```json
{
    "data": {
        "d7": 7882975448,
        "d30": 17060074338,
        "h24": 934626919,
        "name": "Jupiter Aggregator",
        "slug": "jupiter-aggregator",
        "chains": [
            "Solana"
        ],
        "source": "DeFiLlama",
        "all_time": 1230851522707,
        "category": "DEX Aggregator"
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:46.418Z",
        "request_id": "5032829d-c175-4343-8ea7-02c261873d6a"
    },
    "status": "ok",
    "message": "Aggregator retrieved successfully",
    "success": true
}
```

### Chain

#### `GET /v1/chain` — Aggregator volume + top routers for a chain

**Parameters:**
- `chain` (query, required, string) — DeFiLlama chain slug Example: `solana`
- `limit` (query, optional, string) — Max aggregators (1-200) Example: `25`

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

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "source": "DeFiLlama",
        "total_d7": 11231776342,
        "total_d30": 27606349334,
        "total_h24": 1378703712,
        "aggregators": [
            {
                "d7": 7882975448,
                "y1": 324864311879,
                "d30": 17060074338,
                "h24": 934626919,
                "name": "Jupiter Aggregator",
                "chains": [
                    "Solana"
                ],
                "category": "DEX Aggregator"
            },
            {
                "d7": 1948270704,
                "y1": 56561040717,
                "d30": 5510346687,
                "h24": 205495090,
                "name": "DFlow Aggregator",
                "chains": [
                    "Solana"
                ],
                "category": "DEX Aggregator"
            },
            {
                "d7": 869806103,
                "y1": 31033402073,
                "d30": 2529060837,
                "h24": 141399381,
                "name": "OKX Swap",
                "chains": [
                    "Ethereum",
                    "BSC",
                    "OKTChain",
                    "Polygon",
                    "Tron",
                    "Avalanche",
                    "Fantom",
                    "Arbitrum",
                    "OP Mainnet",
                    "Cronos",
                    "Solana",
                    "Osmosis",
                    "Aptos",
                   
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Dollar amounts are USD. aggregator/chain are DeFiLlama slugs (jupiter-aggregator, 1inch, solana, ethereum).",
        "source": "DeFiLlama aggregators (api.llama.fi/overview/aggregators & /summary/aggregators, live)",
        "service": "dexaggregators-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/chain": "Aggregator volume and top routers for one chain (chain=solana).",
            "GET /v1/overview": "Total aggregator volume plus aggregators ranked by 24h routed volume (limit=50).",
            "GET /v1/aggregator": "One aggregator's volume — 24h/7d/30d/all-time (aggregator=jupiter-aggregator)."
        },
        "description": "Live trading volume routed through DeFi DEX aggregators (Jupiter, 1inch, CowSwap, Paraswap…), from DeFiLlama. Aggregators don't hold liquidity — they split a trade across many DEXes for the best price, so their volume is the best measure of where swap flow actually routes. The overview endpoint returns total aggregator volume (24h/7d/30d) plus every aggregator ranked by what it routes; the aggregator endpoint returns one aggregator's figures (24h/7d/30d/all-time); the chain endpoint returns aggregator volume and top routers for one blockchain. Live, no key, nothing stored. The swap-routing / aggregator-volume cut of DeFi — distinct from the spot-DEX-volume, fees-and-revenue, TVL and exchange-ticker APIs.",
        "upstream_status": "ok",
        "total_volum
…(truncated, see openapi.json for full schema)
```


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