Search
⌘K
Token API
API version: 1.4
Introduction
Quickstart guide
Methods
[DEPRECATED] Get multi-chain tokens by category GET
[DEPRECATED] Get multi-chain tokens by category GET
Get multi-chain tokens by category GET
[DEPRECATED] Get tokens by category GET
[DEPRECATED] Get tokens by category GET
Get tokens by category GET
[DEPRECATED] 1inch whitelisted multi-chain tokens GET
[DEPRECATED] 1inch whitelisted multi-chain tokens in list format GET
[DEPRECATED] Get all supported chain ids GET
[DEPRECATED] 1inch whitelisted multi-chain tokens GET
[DEPRECATED] 1inch whitelisted multi-chain tokens in list format GET
[DEPRECATED] Get all supported chain ids GET
Get whitelisted multi-chain tokens GET
Get whitelisted multi-chain tokens in Uniswap token list format GET
Get all supported blockchain networks GET
[DEPRECATED] Search multi-chain tokens by name or symbol GET
[DEPRECATED] Search multi-chain tokens by name or symbol GET
Search tokens across all supported chains GET
Search multi-chain tokens by symbol (chips) GET
Search token pairs for trading GET
[DEPRECATED] 1inch whitelisted tokens GET
[DEPRECATED] 1inch whitelisted tokens GET
1inch whitelisted tokens GET
[DEPRECATED] 1inch whitelisted tokens in list format GET
[DEPRECATED] 1inch whitelisted tokens in list format GET
1inch whitelisted tokens in list format GET
[DEPRECATED] Search tokens by name or symbol GET
[DEPRECATED] Search tokens by name or symbol GET
Search tokens on a specific chain GET
[DEPRECATED] Get many tokens GET
[DEPRECATED] Get many tokens GET
Get many tokens GET
[DEPRECATED] Get single token GET
[DEPRECATED] Get single token GET
Get single token GET
Search tokens by symbol (chips) GET
Search tokens by symbol and generate trading pairs GET
Docs·APIs·Token API·Methods·1.4·Search tokens by symbol and generate trading pairs

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.

GEThttps://api.1inch.com/token/v1.4/{chainId}/chipssearch/pairs
Supported on:
ArbitrumAvalancheBaseBNB ChainZKsyncEthereumGnosisOptimismPolygonLineaSonicUnichain

Parameters

chainId
* number path
Blockchain network ID (e.g., 1 for Ethereum, 56 for BSC, 137 for Polygon)
query
string query
Token symbol prefix to search for (e.g., "USD" matches USDC, USDT)
replaceNativeWithWrappedInSource
boolean query
If true, replaces native token (e.g., ETH) with its wrapped version (e.g., WETH) in source position
limit
number query
Maximum number of token pairs to return (1-100)
country
object query
cursor
string query
Base64-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.

1

Returns

200
400
SearchPairsResponse object
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
1

Did you find what you need?