Search DEX pairs by symbol/name/address API

Free-text search across all DEX pools (symbol, name, or address), returning the best-match pool plus the top-N by liquidity, normalized + liquidity-tiered, with a chain/dex rollup. Answers 'find the canonical USDC/WETH pool', 'which DEXes list this token?'.

Price$0.01per request

MethodPOST

Route/v1/chain/dexscreener-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache120s public

chaindefidexdexscreenersearchliquiditypairs

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

Integration docs

Example request

{
  "query": "USDC WETH"
}

Example response

{
  "query": "USDC WETH",
  "resultCount": 30,
  "bestMatch": {
    "chain": "solana",
    "dex": "raydium",
    "pairAddress": "3hesw9M9AjsNaU9XzK4VCDbPYigpBwcybSg4c9pHRuWN",
    "url": "https://dexscreener.com/solana/3hesw9m9ajsnau9xzk4vcdbpyigpbwcybsg4c9phruwn",
    "base": {
      "address": "GtcELwcT5WbVgAik26ffKxtUmd3mgtbWy3oHMTTVQCZx",
      "symbol": "WETH",
      "name": "WETH"
    },
    "quote": {
      "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "name": "USD Coin"
    },
    "priceUsd": 2624.66,
    "liquidityUsd": 8858058396.46,
    "volume24hUsd": 3.99,
    "priceChange24hPct": null,
    "fdv": 8859061015,
    "marketCap": 8859061015,
    "txns24h": {
      "buys": 1,
      "sells": 1
    },
    "buyPressure24h": 0.5,
    "ageDays": 370,
    "liquidityTier": "deep"
  },
  "chains": [
    "solana",
    "manta",
    "soneium",
    "scroll",
    "linea",
    "hedera",
    "cronos",
    "zksync",
    "worldchain",
    "aptos",
    "metis",
    "ink",
    "mode"
  ],
  "dexes": [
    "orca",
    "quickswap",
    "velodrome",
    "syncswap",
    "kyo-finance",
    "etherex",
    "saucerswap",
    "vvsfinance",
    "0x1d25AF2b0992bf227b350860Ea80Bad47382CAf6",
    "uniswap",
    "raydium",
    "0xB11042007e78bE92dc1c79DA1e7eF499b4B31838",
    "pancakeswap",
    "meteora",
    "oku",
    "netswap",
    "nuri",
    "0x640887A9ba3A9C53Ed27D0F7e8246A4F933f3424",
    "kim",
    "lynex"
  ],
  "topPairs": [
    {
      "chain": "solana",
      "dex": "raydium",
      "pairAddress": "3hesw9M9AjsNaU9XzK4VCDbPYigpBwcybSg4c9pHRuWN",
      "url": "https://dexscreener.com/solana/3hesw9m9ajsnau9xzk4vcdbpyigpbwcybsg4c9phruwn",
      "base": {
        "address": "GtcELwcT5WbVgAik26ffKxtUmd3mgtbWy3oHMTTVQCZx",
        "symbol": "WETH",
        "name": "WETH"
      },
      "quote": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "priceUsd": 2624.66,
      "liquidityUsd": 8858058396.46,
      "volume24hUsd": 3.99,
      "priceChange24hPct": null,
      "fdv": 8859061015,
      "marketCap": 8859061015,
      "txns24h": {
        "buys": 1,
        "sells": 1
      },
      "buyPressure24h": 0.5,
      "ageDays": 370,
      "liquidityTier": "deep"
    },
    {
      "chain": "solana",
      "dex": "raydium",
      "pairAddress": "7M2J1MBYRigAv7rrrBYDqFqiRjcTTymWzyDNk7yQMjk8",
      "url": "https://dexscreener.com/solana/7m2j1mbyrigav7rrrbydqfqirjcttymwzydnk7yqmjk8",
      "base": {
        "address": "Dz9ReLesbbum8zEcUbC2P6DenzZKeGXjb1xpU8NoeE2Q",
        "symbol": "WETH",
        "name": "WETH"
      },
      "quote": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC",
        "name": "USD Coin"
      },
      "priceUsd": 2620.2,
      "liquidityUsd": 8843013241.4,
      "volume24hUsd": 3.99,
      "priceChange24hPct": null,
      "fdv": 8844014157,
      "marketCap": 8844014157,
      "txns24h": {
        "buys": 1,
        "sells": 1
      },
      "buyPressure24h": 0.5,
      "ageDays": 386,
      "liquidityTier": "deep"
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text query: token symbol, name, pair, or address."
    }
  }
}

Output schema

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