ab_get_balance
Fetch current on-chain wallet balances including native ETH and ERC-20 tokens using address or ENS name resolution.
Instructions
Fetch the current on-chain balance for a wallet.
CAPABILITIES • Native ETH balance (default) • ERC-20 balance via tokenAddress OR well-known tokenSymbol (lookup table) • ENS name resolution for the target address
EXAMPLES
Native balance → { address: "vitalik.eth" }
ERC-20 balance via symbol → { address: "0x123…", tokenSymbol: "USDC" }
ERC-20 via contract → { address: "0xabc…", tokenAddress: "0xA0b8…" }
RETURNS • Human-readable string (e.g. "12.3456")
SECURITY • Read-only operation, no gas spent; safe to run frequently.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | Target wallet (address or ENS) to query | |
| tokenAddress | No | ERC-20 token address | |
| tokenSymbol | No | Token symbol to resolve (e.g. USDC) |