Skip to main content

​
Returns

​
Arguments

​
Usage Guidelines

  • Query using tokenAddress (contract address) and networkId (chain ID)
  • Results are sorted by liquidity, with the highest liquidity pairs first
  • token contains metadata for the higher-liquidity token in the pair
  • backingToken contains metadata for the lower-liquidity token in the pair
  • 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

In each result, token is the token with higher liquidity in the pair (typically the major/stable token like WETH, USDC), while backingToken is the token with lower liquidity (typically the token you’re querying for). This helps identify which side of the pair is which.
listPairsWithMetadataForToken returns pairs for a specific token with rich metadata including exchange info. filterPairs is more flexible for searching across all pairs with various filters but returns less detailed metadata per result.
Only pairs with sufficient liquidity and trading activity are indexed. Very new pairs or those with minimal liquidity may not appear immediately.
This query returns liquidity and volume but not current prices. Use pairMetadata with the pair ID from the results to get detailed price and stats data.
This query returns all pairs for a token across all exchanges. To filter by specific exchanges, use filterPairs with the exchangeAddress filter instead.