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 TOKEN BALANCES

GET 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

Path Parameters

Name	Type	Description
Address	string	The wallet address/ ENS names for which we are required to fetch data for.
Chain	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 solana - Solana

Query Parameters

Name	Type	Description
auth_key	string	Demo Key - VGVtcEtleQ==

200 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"
  }
]