# Uniswap Protocol API
> Live protocol metrics for Uniswap, the largest decentralized exchange (DEX), keyless. Get the total value locked across every chain Uniswap is deployed on, DEX trading volume (24h / 7d / 30d / all-time, with change), protocol fees, and the top Uniswap liquidity pools with their TVL and APY (Uniswap v2 / v3 / v4). One combined overview endpoint snapshots it all. Live, nothing stored. The Uniswap-metrics layer for DeFi dashboards, analytics, yield and trading apps — distinct from generic DeFi/TVL browsers, this is Uniswap specifically, multi-chain.

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

## Pricing
- **Free** (Free) — 2,000 calls/Mo, 3 req/s
- **Starter** ($18/Mo) — 60,000 calls/Mo, 8 req/s
- **Pro** ($64/Mo) — 400,000 calls/Mo, 20 req/s
- **Business** ($189/Mo) — 3,000,000 calls/Mo, 50 req/s

## Endpoints

### Overview

#### `GET /v1/overview` — Combined Uniswap snapshot (TVL + volume + fees + top pool)

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

**Response:**
```json
{
    "data": {
        "note": "Snapshot of Uniswap across all chains: TVL, DEX volume, fees and the single largest pool.",
        "source": "DeFiLlama",
        "fees_24h": 638617,
        "fees_30d": 52824239,
        "protocol": "Uniswap",
        "top_pool": {
            "apy": 18.42,
            "tvl": 99695853,
            "chain": "Base",
            "symbol": "WETH-USDC",
            "il_risk": "yes",
            "pool_id": "b99bcdf5-1350-4269-981e-0e9b5cccb007",
            "version": "v3",
            "apy_base": 18.42,
            "apy_reward": null,
            "volume_24h": 16774267.8
        },
        "total_tvl": 2811641757,
        "volume_7d": 8597343326,
        "volume_24h": 604051347,
        "chain_count": 46
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:39.296Z",
        "request_id": "ac2b59a9-0542-45ce-ac60-94ab0ca4a985"
    },
    "status": "ok",
    "message": "Uniswap overview retrieved successfully",
    "success": true
}
```

### Metrics

#### `GET /v1/fees` — Uniswap protocol fees (24h/7d/30d)

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

**Response:**
```json
{
    "data": {
        "note": "Trading fees paid by users (these accrue to Uniswap liquidity providers), in USD.",
        "chains": [
            "Ethereum",
            "Arbitrum",
            "OP Mainnet",
            "Polygon",
            "Celo",
            "BSC",
            "ZKsync Era",
            "Sei",
            "Taiko",
            "Scroll",
            "Rootstock",
            "Filecoin",
            "Boba",
            "Moonbeam",
            "Manta",
            "Mantle",
            "Linea",
            "Avalanche",
            "Base",
            "Zora",
            "Blast",
            "Polygon zkEVM",
            "Gnosis",
            "BOB",
            "Lisk",
            "Corn",
            "Unichain",
            "World Chain",
            "Ink",
            "Soneium",
            "Hemi",
            "Saga",
            "LightLink",
            "GOAT",
            "XDC",
            "Lens",
            "Telos",
            "Nibiru",
            "Plasma",
            "Monad",
            "Etherlink",
            "Sonic",
            "X Layer",
            "Tempo"
        ],
        "source": "DeFiLlama",
        "fees_7d": 9562834,
        "fees_24h": 638617,
        "fees_30d": 52824239,
        "protocol": "Uniswap",
        "change_1d_pct": -31.95,
        "change_7d_pct": null,
        "fees_all_time": 5594289638
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:39.375Z",
        "request_id": "dcf50d3b-9e1d-41ae-957f-bcce580d0791"
    
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/tvl` — Uniswap TVL total and per-chain breakdown

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

**Response:**
```json
{
    "data": {
        "chains": [
            {
                "tvl": 1901108729,
                "chain": "Ethereum"
            },
            {
                "tvl": 411626010,
                "chain": "Base"
            },
            {
                "tvl": 196020179,
                "chain": "Arbitrum"
            },
            {
                "tvl": 124473617,
                "chain": "BSC"
            },
            {
                "tvl": 72113444,
                "chain": "Polygon"
            },
            {
                "tvl": 18445597,
                "chain": "Unichain"
            },
            {
                "tvl": 17584799,
                "chain": "Monad"
            },
            {
                "tvl": 12300507,
                "chain": "X Layer"
            },
            {
                "tvl": 11662994,
                "chain": "OP Mainnet"
            },
            {
                "tvl": 10763572,
                "chain": "Plasma"
            },
            {
                "tvl": 9168439,
                "chain": "Gnosis"
            },
            {
                "tvl": 5016573,
                "chain": "Avalanche"
            },
            {
                "tvl": 4423262,
                "chain": "Celo"
            },
            {
                "tvl": 3188231,
                "chain": "Rootstock"
            },
            {
                "tvl": 2943529,
                "chain": "Soneium"
            },
            {
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/volume` — Uniswap DEX trading volume (24h/7d/30d/all-time, with change)

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

**Response:**
```json
{
    "data": {
        "note": "DEX trading volume across all Uniswap deployments, in USD.",
        "chains": [
            "Ethereum",
            "Arbitrum",
            "OP Mainnet",
            "Polygon",
            "Celo",
            "ZKsync Era",
            "Sei",
            "Taiko",
            "Scroll",
            "Rootstock",
            "Filecoin",
            "Boba",
            "Moonbeam",
            "Manta",
            "Mantle",
            "Linea",
            "BSC",
            "Avalanche",
            "Base",
            "Zora",
            "Blast",
            "Polygon zkEVM",
            "Gnosis",
            "BOB",
            "Lisk",
            "Corn",
            "Unichain",
            "World Chain",
            "Ink",
            "Soneium",
            "Hemi",
            "Saga",
            "LightLink",
            "GOAT",
            "XDC",
            "Lens",
            "Telos",
            "Nibiru",
            "Plasma",
            "Monad",
            "Etherlink",
            "Sonic",
            "X Layer",
            "Tempo"
        ],
        "source": "DeFiLlama",
        "protocol": "Uniswap",
        "volume_7d": 8597343326,
        "volume_24h": 604051347,
        "volume_30d": 41539216070,
        "change_1d_pct": -47.57,
        "change_7d_pct": null,
        "change_30d_pct": null,
        "volume_all_time": 3705560478591
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:39.517Z",
        "request_id": "876e0cae-f2de
…(truncated, see openapi.json for full schema)
```

### Pools

#### `GET /v1/pools` — Top Uniswap liquidity pools with TVL and APY

**Parameters:**
- `version` (query, optional, string) — Uniswap version: v2, v3 or v4 Example: `v3`
- `chain` (query, optional, string) — Filter by chain (e.g. Ethereum, Base, Arbitrum) Example: `Ethereum`
- `limit` (query, optional, string) — Results (1-100, default 25) Example: `25`
- `min_tvl` (query, optional, string) — Minimum pool TVL in USD Example: `1000000`
- `sort` (query, optional, string) — Sort by tvl or apy Example: `tvl`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/uniswap-api/v1/pools?version=v3&chain=Ethereum&limit=25&min_tvl=1000000&sort=tvl"
```

**Response:**
```json
{
    "data": {
        "sort": "tvl",
        "chain": "Ethereum",
        "count": 25,
        "pools": [
            {
                "apy": 3.04,
                "tvl": 86092559,
                "chain": "Ethereum",
                "symbol": "USDC-WETH",
                "il_risk": "yes",
                "pool_id": "665dc8bc-c79d-4800-97f7-304bf368e547",
                "version": "v3",
                "apy_base": 3.04,
                "apy_reward": null,
                "volume_24h": 14363679.04
            },
            {
                "apy": 12.06,
                "tvl": 73711193,
                "chain": "Ethereum",
                "symbol": "WETH-USDT",
                "il_risk": "yes",
                "pool_id": "fc9f488e-8183-416f-a61e-4e5c571d4395",
                "version": "v3",
                "apy_base": 12.06,
                "apy_reward": null,
                "volume_24h": 8118520.77
            },
            {
                "apy": 2.58,
                "tvl": 41302157,
                "chain": "Ethereum",
                "symbol": "WBTC-WETH",
                "il_risk": "yes",
                "pool_id": "d59a5728-d391-4989-86f6-a94e11e0eb3b",
                "version": "v3",
                "apy_base": 2.58,
                "apy_reward": null,
                "volume_24h": 5831157.62
            },
            {
                "apy": 0.38,
                "tvl": 33726694,
                "chain": "Ethereum",
                "symbol": "WBTC-WETH",
 
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata & live sample

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

**Response:**
```json
{
    "data": {
        "note": "pools takes optional version (v2, v3, v4), chain (e.g. Ethereum, Base, Arbitrum), limit (1-100), min_tvl and sort (tvl or apy). All money values are USD. Other endpoints take no parameters.",
        "sample": {
            "total_tvl": 2811641757,
            "volume_24h": 604051347
        },
        "source": "DeFiLlama open API (api.llama.fi + yields.llama.fi), live",
        "service": "uniswap-api",
        "endpoints": {
            "GET /v1/tvl": "Uniswap TVL total and per-chain breakdown.",
            "GET /v1/fees": "Uniswap protocol fees (24h/7d/30d).",
            "GET /v1/meta": "This document.",
            "GET /v1/pools": "Top Uniswap liquidity pools with TVL and APY (version, chain, limit, sort).",
            "GET /v1/volume": "Uniswap DEX trading volume (24h/7d/30d/all-time, with change).",
            "GET /v1/overview": "Combined Uniswap snapshot (TVL + volume + fees + top pool)."
        },
        "description": "Live protocol metrics for Uniswap, the largest decentralized exchange (DEX), keyless. Total value locked across every chain Uniswap is deployed on, DEX trading volume (24h/7d/30d/all-time with change), protocol fees, and the top Uniswap liquidity pools with TVL and APY (v2/v3/v4). Live, nothing stored beyond a short protective cache. The Uniswap-metrics layer for DeFi dashboards, analytics, yield and trading apps. Distinct from generic DeFi/TVL browsers — Uniswap specifically, multi-chain.",
        "upstream
…(truncated, see openapi.json for full schema)
```


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