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 by display_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

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 by display_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

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, bsc

• chain_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

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, bsc

• chain_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

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
}