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.null
if not defined in the contract and not available from other sources.symbol
:string
- The token's symbol.null
if 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 || symbol
decimals
:integer
- The number of decimals of the token.null
if 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.null
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?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.null
if not defined in the contract and not available from other sources.symbol
:string
- The token's symbol.null
if 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 || symbol
decimals
:integer
- The number of decimals of the token.null
if not defined in the contract and not available from other sources.logo_url
:string
- URL of the token's logo image.null
if 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
:string
required, token address, also support native token id, eg. eth, bscchain_id
: required, chain id, eg:eth
,bsc
,xdai
, for more info.start
:integer
offset, default is 0, max is 10000.limit
:integer
limit 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
:string
required, token address, also support native token id, eg. eth, bscchain_id
: required, chain id, eg:eth
,bsc
,xdai
, for more info.date_at
:string
required, 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