Get single token
Get detailed information for a single token by its contract address. Returns token metadata including symbol, name, decimals, logo, rating, and trading metadata.
Supported on: Ethereum Base BNB Chain Gnosis Optimism Polygon Linea Sonic Unichain Arbitrum Avalanche ZKsync
Parameters
chainId
* object path address
* string pathToken contract address
Request 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
const axios = require('axios');
async function httpCall() {
const url = 'https://api.1inch.com/token/v1.4/{chainId}/custom/{address}';
const config = {
headers: {
Authorization: `Bearer ${API_KEY}`,
},
params: {},
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
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
{
"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"]
}