Skip to content

@token:balance

Fetch the token balance of an address in base units.

Returns: number

@token:balance(tokenSymbol holder)
NameTypeDescription
tokenSymboltoken-symbolToken symbol (e.g. DAI) or address
holderaddressAddress to query
# Query a token balance
set $bal @token:balance(DAI @token(DAI))
  • @token — resolve a token symbol to its address
  • @token:amount — convert to base units
  • @token:format — format base units as a human-readable string
  • @get — generic contract reads