Skip to main content

Function Signature

Description

Returns a flat list of token balances for the wallet on the specified chain — each entry includes a contract address, balance, and (optionally) token name and symbol. This is a lighter-weight alternative to getAssets when you only need basic balance information without the additional metadata (logos, decimals, asset type) that getAssets returns.

Parameters

Returns

List<PortalBalance> — A list of token balances on the chain.

PortalBalance

Example

Basic balance check

Multi-chain balances

Filtering non-zero balances

Errors

Throws a PortalException on failure:

Implementation Notes

  • Balances are returned as raw string values in the token’s smallest unit (e.g., wei for ETH, lamports for SOL). Apply token decimals when displaying balances to users.
  • Both EVM and Solana chains are supported — pass the appropriate CAIP-2 chain ID.
  • For richer metadata (logos, asset type, native vs. token grouping), use getAssets instead.
  • Consider rate limiting when polling balances frequently.