# DEX Pairs API
> Live decentralised-exchange trading-pair data — no key, nothing cached. For any token or trading pair across every major chain and DEX (Ethereum, Solana, BSC, Base, Arbitrum, Polygon and dozens more, on Uniswap, Raydium, PancakeSwap and the rest) it returns the live on-DEX market: the price in USD and in the native quote token, the pool liquidity, the 24-hour volume, the fully-diluted valuation and market cap, the price change over 5 minutes, 1, 6 and 24 hours, and the count of buy and sell transactions. The search endpoint finds every pair matching a token symbol, name or address. The token endpoint returns all the pools a token trades in, ranked by liquidity, so you can find where the real liquidity is — Wrapped Ether trades in pools led by a Uniswap WETH/USDC pool with tens of millions in liquidity. The pair endpoint returns one specific pool by chain and pair address in full detail. This is the DEX market-data layer every trading, screener, wallet, sniping and portfolio app needs — real pools, real prices, every chain. Live from DexScreener, nothing stored. Distinct from aggregate DEX-volume and centralised-exchange ticker APIs — this is per-pair on-DEX data. 4 endpoints.

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

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 3 req/s
- **Starter** ($10/Mo) — 130,000 calls/Mo, 8 req/s
- **Pro** ($26/Mo) — 630,000 calls/Mo, 15 req/s
- **Scale** ($60/Mo) — 3,150,000 calls/Mo, 30 req/s

## Endpoints

### DEX

#### `GET /v1/pair` — One pair by chain + address

**Parameters:**
- `chain` (query, required, string) — Chain Example: `ethereum`
- `address` (query, required, string) — Pair/pool address Example: `0xE0554a476A092703abdB3Ef35c80e0D76d32939F`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexpairs-api/v1/pair?chain=ethereum&address=0xE0554a476A092703abdB3Ef35c80e0D76d32939F"
```

**Response:**
```json
{
    "data": {
        "dex": "uniswap",
        "fdv": 4307722042,
        "url": "https://dexscreener.com/ethereum/0xe0554a476a092703abdb3ef35c80e0d76d32939f",
        "base": {
            "name": "Wrapped Ether",
            "symbol": "WETH",
            "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
        },
        "chain": "ethereum",
        "quote": {
            "symbol": "USDC",
            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        "txns_24h": {
            "buys": 11087,
            "sells": 9526
        },
        "price_usd": 1668.36,
        "volume_1h": 726495.28,
        "volume_6h": 7460447.17,
        "market_cap": 4307722042,
        "volume_24h": 39968425.04,
        "pair_address": "0xE0554a476A092703abdB3Ef35c80e0D76d32939F",
        "price_native": 1668.3656,
        "liquidity_usd": 3504048.73,
        "pair_created_at": 1636926269000,
        "price_change_pct": {
            "h1": -0.13,
            "h6": -1.39,
            "m5": -0.05,
            "h24": -1.34
        }
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:50.134Z",
        "request_id": "07107998-5ad9-4071-8582-251d98446cd4"
    },
    "status": "ok",
    "message": "Pair retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search DEX pairs

**Parameters:**
- `q` (query, required, string) — Token symbol, name or address Example: `WETH`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

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

**Response:**
```json
{
    "data": {
        "count": 20,
        "pairs": [
            {
                "dex": "orca",
                "fdv": 145389278,
                "url": "https://dexscreener.com/solana/hktfl7iwgkt5qhjywqkcdnzxscoh811k7akrmzjkccef",
                "base": {
                    "name": "Wrapped Ether (Wormhole)",
                    "symbol": "WETH",
                    "address": "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs"
                },
                "chain": "solana",
                "quote": {
                    "symbol": "SOL",
                    "address": "So11111111111111111111111111111111111111112"
                },
                "txns_24h": {
                    "buys": 6838,
                    "sells": 7109
                },
                "price_usd": 1669.79,
                "volume_1h": 224037.92,
                "volume_6h": 1820919.88,
                "market_cap": 145389278,
                "volume_24h": 12355690.88,
                "pair_address": "HktfL7iwGKT5QHjywQkcDnZXScoh811k7akrMZJkCcEF",
                "price_native": 25.2999,
                "liquidity_usd": 4343707.49,
                "pair_created_at": 1669602341000,
                "price_change_pct": {
                    "h1": -0.03,
                    "h6": -1.46,
                    "m5": 0.07,
                    "h24": -1.54
                }
            },
            {
                "dex": "raydium",
                "fdv": 4116088,
                "url": "https://d
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/token` — All pools for a token

**Parameters:**
- `address` (query, required, string) — Token address (EVM 0x… or Solana mint) Example: `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
- `limit` (query, optional, string) — How many (default 20, max 50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dexpairs-api/v1/token?address=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "pairs": [
            {
                "dex": "uniswap",
                "fdv": 4306587940,
                "url": "https://dexscreener.com/ethereum/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
                "base": {
                    "name": "Wrapped Ether",
                    "symbol": "WETH",
                    "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                },
                "chain": "ethereum",
                "quote": {
                    "symbol": "USDC",
                    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
                },
                "txns_24h": {
                    "buys": 6189,
                    "sells": 5499
                },
                "price_usd": 1667.92,
                "volume_1h": 980680.74,
                "volume_6h": 7946724.59,
                "market_cap": 4306587940,
                "volume_24h": 80685092.32,
                "pair_address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
                "price_native": 1667.9263,
                "liquidity_usd": 85084855.6,
                "pair_created_at": 1620250931000,
                "price_change_pct": {
                    "h1": -0.16,
                    "h6": -1.39,
                    "m5": -0.05,
                    "h24": -1.4
                }
            },
            {
                "dex": "uniswap",
                "fdv": 4315119008,
                "url": "https://dexs
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "source": "DexScreener public API (live)",
        "service": "dexpairs-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/pair": "One pair in full detail (chain=ethereum, address=0x… pair address).",
            "GET /v1/token": "All pools a token trades in, ranked by liquidity (address=0x… or Solana mint).",
            "GET /v1/search": "Search pairs by token symbol, name or address (q=WETH, limit up to 50)."
        },
        "description": "Live decentralised-exchange trading-pair data from DexScreener: for any token or pair across every major chain and DEX, the live price (USD and native), pool liquidity, 24h volume, FDV and market cap, price change over 5m/1h/6h/24h and buy/sell transaction counts. Search pairs by token symbol/name/address, list all pools a token trades in ranked by liquidity, or fetch one pair by chain and pair address. Live, no key, nothing stored. Distinct from aggregate DEX-volume and centralised-exchange ticker APIs — this is per-pair on-DEX data.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T11:39:50.699Z",
        "request_id": "fa3d82a0-c2e2-4805-8f0d-3b8804043536"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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