Search tokens by symbol and generate trading pairs
Search for tokens by symbol and generate trading pairs. Combines chips search with pair generation for efficient trading pair discovery. Results are paginated using cursor-based pagination.
Supported on: Ethereum Base BNB Chain Gnosis Optimism Polygon Linea Sonic Unichain Arbitrum Avalanche ZKsync
Parameters
chainId
* number pathBlockchain network ID (e.g., 1 for Ethereum, 56 for BSC, 137 for Polygon)
query
string queryToken symbol prefix to search for (e.g., "USD" matches USDC, USDT)
replaceNativeWithWrappedInSource
boolean queryIf true, replaces native token (e.g., ETH) with its wrapped version (e.g., WETH) in source position
limit
number queryMaximum number of token pairs to return (1-100)
country
object query cursor
string queryBase64-encoded cursor for pagination. Use the cursor from the previous response to fetch the next page.
Request Body
This request doesn’t have any request body.
JavaScript
Copy
1
Returns
200
400
pairs
* array Array of token pairs (each pair is an array of two token addresses)
items
string tokens
* array Array of token details
items
TokenResponse object chainId
* number Blockchain network ID
symbol
* string Token symbol
name
* string Token name
address
* string Token contract address
decimals
* number Number of decimals for token amounts
logoURI
string URL to token logo image
rating
* number Token rating score based on community trust
eip2612
boolean Whether token supports EIP-2612 permit signatures
isFoT
boolean Whether token has fee-on-transfer mechanism
blacklisted
* boolean Whether the token is blacklisted
tags
* array Token tags with provider information
items
TagResponse object provider
* string value
* string marketCap
number Token market capitalization in USD
providers
* array List of providers that support this token
items
string page
* any Pagination information
allOf[0]
PageInfoResponse object nextCursor
string Cursor for next page
hasMore
* boolean Whether there are more results
JSON
Copy
1