Usage Guidelines
- Response limit: 200 pairs per request
- Use
phraseparameter for searching by token name, symbol, or pair address - Apply quality filters such as volume and liquidity minimums to avoid low quality pairs
- Results include pre-computed stats like
priceChange24,volumeUSD24,buyCount12, etc. for easy display
Troubleshooting Tips
When should I use filterPairs vs filterTokens?
When should I use filterPairs vs filterTokens?
Use
filterPairs when you want to discover or search trading pairs and need pair-specific data like which tokens are paired together. Use filterTokens when you want to discover tokens and need token-level aggregate data across all their pairs.How do I get the token I care about from pair results?
How do I get the token I care about from pair results?
Each pair has
token0Data and token1Data. One will be your target token, the other is typically a quote token (like USDC, WETH, or SOL). Check the address field to identify which is which, or filter by a known quote token address.Results are returning too many low-quality pairs
Results are returning too many low-quality pairs
Add quality filters to improve results. Set minimum thresholds for
liquidity and volumeUSD24 to filter out inactive or low-liquidity pairs.How do I filter pairs for a specific token?
How do I filter pairs for a specific token?
Use the
token0 or token1 filter with the token address, or use phrase to search by token name/symbol. You can also filter by network to narrow results to a specific chain.