Token Balance APIs

This endpoint allows you to retrieve balance tied to a particular address on a specific chain.The response of this API will let you understand in details about all your assets.

The token balances API gives a detailed picture of the given wallet address with details like the list of all the tokens on the chosen chain and the balances of each token and their value in USD.

get
GET TOKEN BALANCES

https://stg-api.unmarshal.io/v1/{chain}/address/{address}/assets?auth_key={}
Sample API : https://stg-api.unmarshal.io/v1/ethereum/address/ 0xb13943b4CC5B8F03A2e2872842C7E4118abdAe6F/assets?auth_key=VGVtcEtleQ%3D%3D
Request
Response
Request
Path Parameters
Address
required
string
The wallet address/ ENS names for which we are required to fetch data for.
Chain
required
string
Users will be able to fetch data on Ethereum Chain , Binance Smart Chain or Polygon Chain data. The various chains for which the data could be fetched are as below(in bold) ethereum - for ethereum chain bsc - for Binance Smart Chain matic - for Polygon chain stafi - StaFi edgeware - Edgeware heco - Huobi Eco polkadot - PolkaDot ziliqa - Ziliqa
Query Parameters
auth_key
required
string
Demo Key - VGVtcEtleQ==
Response
200: OK
contract_name : returns the name of the token contract_ticker_symbol : The Symbol of the token contract_decimals : the decimal value of the token contract_address : The contract address of the token type : the kind of token ERC20 / BEP20 / ERC721 / ERC1155 for example balance : gives the number of tokens. The actual number could be deduced along with the knowledge of the decimals quote : The total worth of the token in USD quote_rate : current worth of a single token logo_url : gives the logo of the token
[
{
"contract_name": "Ethereum",
"contract_ticker_symbol": "ETH",
"contract_decimals": 18,
"contract_address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"coin": 60,
"type": "ERC20",
"balance": "1281222328513842997",
"quote": 2596.063930927889,
"quote_rate": 2026.24,
"logo_url": "https://assets.unmarshal.io/tokens/0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE.png"
},
{
"contract_name": "Tether USD",
"contract_ticker_symbol": "USDT",
"contract_decimals": 6,
"contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
"coin": 60,
"type": "ERC20",
"balance": "673056984",
"quote": 673.056984,
"quote_rate": 1,
"logo_url": "https://assets.unmarshal.io/tokens/0xdAC17F958D2ee523a2206206994597C13D831ec7.png"
},
{
"contract_name": "Compound USD Coin",
"contract_ticker_symbol": "cUSDC",
"contract_decimals": 8,
"contract_address": "0x39AA39c021dfbaE8faC545936693aC917d5E7563",
"coin": 60,
"type": "ERC20",
"balance": "46694809331",
"quote": 10.334495201136919,
"quote_rate": 0.022132,
"logo_url": "https://assets.unmarshal.io/tokens/0x39AA39c021dfbaE8faC545936693aC917d5E7563.png"
}
]