Token
The Token API allows you to easily get token information.
Get token information
Method
get
Path
/v1/token
Parameters
chain_id: required, chain id, eg:eth,bsc,xdai, for more info.id: required, - The address of the token contract or a native token id (eth, matic, bsc).
Returns
Object - An object with the following fields:
id:string- The address of the token contract.chain:string- The chain's name.name:string- The token's name.nullif not defined in the contract and not available from other sources.symbol:string- The token's symbol.nullif not defined in the contract and not available from other sources.display_symbol:string- The token's displayed symbol. If two tokens have the same symbol, they are distinguished bydisplay_symbol.optimized_symbol:string- For front-end display.optimized_symbol || display_symbol || symboldecimals:integer- The number of decimals of the token.nullif not defined in the contract and not available from other sources.protocol_id:string- token associated protocol's id. Empty string if not available.logo_url:string- URL of the token's logo image.nullif not available.is_core:boolean- Whether or not to show as a common token in the wallet.price:double- USD price. Price of 0 means no data.time_at:integer- The timestamp when the current token was deployed on the blockchain.
Request
curl -X 'GET' \
'https://pro-openapi.debank.com/v1/token?chain_id=eth&id=0xdac17f958d2ee523a2206206994597c13d831ec7' \
-H 'accept: application/json' -H 'AccessKey: YOUR_ACCESSKEY'Result
{
"id": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"chain": "eth",
"name": "Tether USD",
"symbol": "USDT",
"display_symbol": null,
"optimized_symbol": "USDT",
"decimals": 6,
"logo_url": "https://static.debank.com/image/eth_token/logo_url/0xdac17f958d2ee523a2206206994597c13d831ec7/66eadee7b7bb16b75e02b570ab8d5c01.png",
"protocol_id": "",
"price": 1,
"is_verified": true,
"is_core": true,
"is_wallet": true,
"time_at": 1511829681
}Get the list of the token information
Method
get
Path
/v1/token/list_by_ids
Parameters
chain_id: required, chain id, eg:eth,bsc,xdai, for more info.ids: required, List of token addresses, up to 100.
Returns
Array of Object - An object with following fields:
id:string- The address of the token contract.chain:string- The chain's name.name:string- The token's name.nullif not defined in the contract and not available from other sources.symbol:string- The token's symbol.nullif not defined in the contract and not available from other sources.display_symbol:string- The token's displayed symbol. If two tokens have the same symbol, they are distinguished bydisplay_symbol.optimized_symbol:string- For front-end display.optimized_symbol || display_symbol || symboldecimals:integer- The number of decimals of the token.nullif not defined in the contract and not available from other sources.logo_url:string- URL of the token's logo image.nullif not available.protocol_id:string- token associated protocol's id. Empty string if not available.is_core:boolean- Whether or not to show as a common token in the wallet.price:double- USD price. Price of 0 means no data.time_at:integer- The timestamp when the current token was deployed on the blockchain.
Request
curl -X 'GET' \
'https://pro-openapi.debank.com/v1/token/list_by_ids?chain_id=eth&ids=0xdac17f958d2ee523a2206206994597c13d831ec7,0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48' \
-H 'accept: application/json' -H 'AccessKey: YOUR_ACCESSKEY'Result
[
{
"id": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"chain": "eth",
"name": "USD Coin",
"symbol": "USDC",
"display_symbol": null,
"optimized_symbol": "USDC",
"decimals": 6,
"logo_url": "https://static.debank.com/image/eth_token/logo_url/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/adee072b10b0db7c5bd7a28dd4fbe96f.png",
"protocol_id": "",
"price": 1,
"is_verified": true,
"is_core": true,
"is_wallet": true,
"time_at": 1533324504
},
{
"id": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"chain": "eth",
"name": "Tether USD",
"symbol": "USDT",
"display_symbol": null,
"optimized_symbol": "USDT",
"decimals": 6,
"logo_url": "https://static.debank.com/image/eth_token/logo_url/0xdac17f958d2ee523a2206206994597c13d831ec7/66eadee7b7bb16b75e02b570ab8d5c01.png",
"protocol_id": "",
"price": 1,
"is_verified": true,
"is_core": true,
"is_wallet": true,
"time_at": 1511829681
}
]Get top holders of token
Method
get
Path
/v1/token/top_holders
Parameters
id:stringrequired, token address, also support native token id, eg. eth, bscchain_id: required, chain id, eg:eth,bsc,xdai, for more info.start:integeroffset, default is 0, max is 10000.limit:integerlimit size, default is 100, max is 100.
Returns
Array of address with token amount, in reverse order of holding token amount.
Request
curl -X GET "https://pro-openapi.debank.com/v1/token/top_holders?chain_id=celo&id=celo&start=2&limit=1
-H "accept: application/json" -H 'AccessKey: YOUR_ACCESSKEY'Result
[
[
"0x00000000219ab540356cbb839cbe05303d7705fa", // user_address
13702020.000069 // amount
],
[
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
3624588.4884625035
],
[
"0xda9dfa130df4de4673b89022ee50ff26f6ea73cf",
2113030.0863672243
],
[
"0x0716a17fbaee714f1e6ab0f9d59edbc5f09815c0",
2014609.5884898424
],
[
"0xbe0eb53f46cd790cd13851d5eff43d12404d33e8",
1996008.354181282
]
]Get token history price
Method
get
Path
/v1/token/history_price
Parameters
id:stringrequired, token address, also support native token id, eg. eth, bscchain_id: required, chain id, eg:eth,bsc,xdai, for more info.date_at:stringrequired, UTC time zone. eg. 2023-05-18
Returns
price:float, history price at a specified time.
Request
curl -X GET "https://pro-openapi.debank.com/v1/token/history_price?id=eth&chain_id=eth&date_at=2023-05-18
-H "accept: application/json" -H 'AccessKey: YOUR_ACCESSKEY'Result
{
"price": 1820.89
}Last updated