Search tokens on a specific chain
Search for tokens by name, symbol, or address on a specific blockchain network. Returns matching tokens sorted by relevance, including both whitelisted and custom tokens.
Supported on: Ethereum Base BNB Chain Arbitrum Avalanche ZKsync Gnosis Optimism Polygon Linea Sonic Unichain
Parameters
chainId
* number pathBlockchain network ID (e.g., 1 for Ethereum, 56 for BSC, 137 for Polygon)
query
* string querySearch query - can be a token name, symbol, or contract address
ignore_listed
boolean queryIf true, excludes tokens already in the 1inch whitelist
only_positive_rating
boolean queryIf true, only returns tokens with positive community rating
limit
number queryMaximum number of tokens to return (1-100)
country
object queryRequest Body
This request doesn’t have any request body.
JavaScript
Copy
1
Returns
200
400
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 JSON
Copy
1