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