[DEPRECATED] Search multi-chain tokens by name or symbol
DEPRECATED: This endpoint is deprecated and will be removed in future releases. Please use /v1.4/search instead. Search multi-chain tokens by name or symbol.
Supported on: Ethereum Base BNB Chain Avalanche ZKsync Gnosis Optimism Polygon Linea Sonic Unichain Arbitrum
Parameters
query
string queryText to search for in token address, token symbol, or description
ignore_listed
boolean queryWhether to ignore listed tokens
only_positive_rating
* boolean query limit
number queryMaximum number of tokens to return
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
const axios = require('axios');
async function httpCall() {
const url = 'https://api.1inch.com/token/v1.3/search';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {
query: '1inch',
ignore_listed: false,
limit: 10,
},
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"]
}
]