Actions53
- Account Actions
- Block Actions
- Transaction Actions
- Contract Actions
- ERC20 Actions
- ERC721 Actions
- ERC1155 Actions
- Gas Actions
- Signature Actions
- Utils Actions
- Custom RPC Actions
Account → Get Balance
AI-generatedSummary
Fetch the current balance of an Ethereum address at a specified block.
Inputs
- address — The Ethereum address to query (leave empty to use credential address)
- blockTag — Block identifier to query; options are Latest, Earliest, Pending, or Custom Block Number
- blockNumber — The block number to query (only relevant when blockTag is set to Custom Block Number)
Output shape
a single record containing the account balance
Balance is returned as a string representing the amount in wei; may be null if the address is invalid or the node encounters an error
Examples
Example 1: Query balance using the default latest block
address set to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb, blockTag left as latest (default)
Example 2: Check balance at a custom block number
address = 0x123abc..., blockTag = custom, blockNumber = 12345678
Example 3: Get balance using the 'pending' block tag
address = 0x..., blockTag = pending (no blockNumber required)