listPairsWithMetadataForToken

​

Example

{
  listPairsWithMetadataForToken(
    tokenAddress: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    networkId: 1
    limit: 5
  ) {
    results {
      volume
      liquidity
      quoteToken
      token {
        address
        name
        symbol
        networkId
      }
      backingToken {
        address
        name
        symbol
        networkId
      }
      pair {
        address
        id
        networkId
        fee
        protocol
      }
      exchange {
        name
        iconUrl
        tradeUrl
      }
    }
  }
}

​

Usage Guidelines

• Query using tokenAddress (contract address) and networkId (chain ID)
• Returns up to 250 pairs (default 10). Larger limit values return 250.
• Results are not sorted by liquidity, so sort by liquidity yourself to find the main pair.
• token is always the token you queried (tokenAddress)
• backingToken is the other token in the pair (for example WETH or USDC)
• quoteToken indicates which token (token0 or token1) is the quote token for price calculations
• Use the exchange field to get DEX information including trade URLs

​

Troubleshooting Tips

​

Related Recipes

• Detailed Token Page: Build a comprehensive token detail page with price, holders, trades, and real-time updates