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 togetAssets 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 aPortalException 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
getAssetsinstead. - Consider rate limiting when polling balances frequently.
Related
- getAssets — richer per-asset metadata (logos, decimals, native + token grouping)
- getNftAssets
- getTransactions