Returns
PairFilterConnection
Arguments
PairFilters
A set of filters to apply.
See PairFilters
TokenPairStatisticsType
The type of statistics returned. Can be
FILTERED or UNFILTERED. Default is UNFILTERED.
See TokenPairStatisticsTypeString
A phrase to search for. Can match a token or pair contract address or ID (
address:networkId), or partially match a token name or symbol.[String]
A list of pair or token contract addresses or IDs (
address:networkId) to filter by.PairFilterMatchTokens
A set of token contract addresses that make up a pair. Can be used in place of a pair contract address.
See PairFilterMatchTokens
[PairRanking]
A list of ranking attributes to apply.
See PairRanking
Int
The maximum number of pairs to return.
Int
Where in the list the server should start when returning items. Use
count+offset from the previous query to request the next page of results.Example
Test this query in the Explorer →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.Can I fetch pair metadata for multiple pool addresses?
Can I fetch pair metadata for multiple pool addresses?
Yes — use
filterPairs for this. It accepts pool addresses via the phrase parameter or filters and returns metadata for many pairs in a single call.How do I find the pool with the highest liquidity for a token?
How do I find the pool with the highest liquidity for a token?
Use The
filterPairs with a phrase containing the token’s address (formatted as address:networkId) and rank by liquidity descending:liquidity value represents the USD value of the base token (e.g. ETH or a stablecoin) backing the pair. Price change metrics across multiple timeframes are available on both filterPairs and filterTokens.How does phrase search work for pairs?
How does phrase search work for pairs?
phrase matches pair addresses or the symbols/names of the tokens in the pair. As with filterTokens, avoid sorting by createdAt for phrase searches — use liquidity, volumeUSD24, or trendingScore24 for more meaningful rankings. See filterTokens — How does phrase search work? for the same gotcha at the token level.Related Recipes
- Discover Tokens: Build token discovery pages with trending data, filters, and search