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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
const axios = require('axios');
async function httpCall() {
const url = 'https://api.1inch.com/token/v1.4/{chainId}/search';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {
query: 'USDT',
ignore_listed: false,
only_positive_rating: false,
limit: 50,
},
paramsSerializer: {
indexes: null,
},
};
const body = {};
try {
const response = await axios.get(url, body, config);
console.log(response.data);
} catch (error) {
console.error(error);
}
}
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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
[
{
"chainId": 1,
"symbol": "USDT",
"name": "Tether USD",
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"decimals": 6,
"logoURI": "https://tokens.1inch.io/0xdac17f958d2ee523a2206206994597c13d831ec7.png",
"rating": 5,
"eip2612": true,
"isFoT": false,
"blacklisted": false,
"tags": [
{
"provider": "string",
"value": "string"
}
],
"marketCap": 83351941553,
"providers": ["1inch"]
}
]