Multi-DEX aggregated pairs for a token API

Aggregates every DEX/chain pool for a token address into one authoritative primary pair (deepest liquidity), a liquidity + 24h-volume rollup, and the top-N normalized pools with derived buy-pressure, liquidity tier and age. Answers 'what's the real on-chain price + liquidity of this token across all DEXes?', 'which is the canonical pool to trade?'.

Price$0.01per request

MethodPOST

Route/v1/chain/dexscreener-token-pairs

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache120s public

chaindefidexdexscreenertokenliquiditypriceaggregate

API URLhttps://x402.hexl.dev/v1/chain/dexscreener-token-pairs

Integration docs

Example request

{
  "tokenAddress": "0x4200000000000000000000000000000000000006"
}

Example response

{
  "tokenAddress": "0x4200000000000000000000000000000000000006",
  "found": true,
  "primary": {
    "chain": "base",
    "dex": "uniswap",
    "pairAddress": "0x6c561B446416E1A00E8E93E221854d6eA4171372",
    "url": "https://dexscreener.com/base/0x6c561b446416e1a00e8e93e221854d6ea4171372",
    "base": {
      "address": "0x4200000000000000000000000000000000000006",
      "symbol": "WETH",
      "name": "Wrapped Ether"
    },
    "quote": {
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "name": "USD Coin"
    },
    "priceUsd": 1764.19,
    "liquidityUsd": 105604102.72,
    "volume24hUsd": 211552194.36,
    "priceChange24hPct": -2.73,
    "fdv": 517292398,
    "marketCap": 513778797,
    "txns24h": {
      "buys": 4623,
      "sells": 6289
    },
    "buyPressure24h": 0.424,
    "ageDays": 929,
    "liquidityTier": "deep"
  },
  "pairCount": 30,
  "totalLiquidityUsd": 142839221.02,
  "totalVolume24hUsd": 620618380.37,
  "chains": [
    "soneium",
    "worldchain",
    "zora",
    "base"
  ],
  "dexes": [
    "velodrome",
    "kyo-finance",
    "uniswap",
    "sonefi",
    "sonex",
    "pancakeswap",
    "aerodrome",
    "hydrex",
    "sushiswap",
    "quickswap",
    "alien-base",
    "0x03C01Acae3D0173a93d819efDc832C7C4F153B06"
  ],
  "topPairs": [
    {
      "chain": "base",
      "dex": "uniswap",
      "pairAddress": "0x6c561B446416E1A00E8E93E221854d6eA4171372",
      "url": "https://dexscreener.com/base/0x6c561b446416e1a00e8e93e221854d6ea4171372",
      "base": {
        "address": "0x4200000000000000000000000000000000000006",
        "symbol": "WETH",
        "name": "Wrapped Ether"
      },
      "quote": {
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "priceUsd": 1764.19,
      "liquidityUsd": 105604102.72,
      "volume24hUsd": 211552194.36,
      "priceChange24hPct": -2.73,
      "fdv": 517292398,
      "marketCap": 513778797,
      "txns24h": {
        "buys": 4623,
        "sells": 6289
      },
      "buyPressure24h": 0.424,
      "ageDays": 929,
      "liquidityTier": "deep"
    },
    {
      "chain": "base",
      "dex": "uniswap",
      "pairAddress": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
      "url": "https://dexscreener.com/base/0xd0b53d9277642d899df5c87a3966a349a798f224",
      "base": {
        "address": "0x4200000000000000000000000000000000000006",
        "symbol": "WETH",
        "name": "Wrapped Ether"
      },
      "quote": {
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "priceUsd": 1767.88,
      "liquidityUsd": 9940975.4,
      "volume24hUsd": 48950595.3,
      "priceChange24hPct": -2.33,
      "fdv": 518372131,
      "marketCap": 514851196,
      "txns24h": {
        "buys": 20451,
        "sells": 23361
      },
      "buyPressure24h": 0.467,
      "ageDays": 1002,
      "liquidityTier": "deep"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "tokenAddress"
  ],
  "properties": {
    "tokenAddress": {
      "type": "string",
      "description": "Token contract address (EVM 0x... or non-EVM e.g. Solana base58)."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}