eth_getBalance - Tempo RPC Method
Query account balance on Tempo. Essential for wallet applications and merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications on a payments-first EVM chain with deterministic settlement and stablecoin-native fees.
Returns the balance of a given address on Tempo.
Why Tempo? Build on a payments-first EVM chain with deterministic settlement and stablecoin-native fees with no native gas token, fees denominated in supported USD stablecoins, and full EVM RPC compatibility.
Use Cases
The eth_getBalance method is essential for:
- Wallet applications - Display user balances
- Transaction validation - Check if account has sufficient funds
- DeFi applications - Monitor collateral and liquidity for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications
- Account monitoring - Track balance changes over time
Request Parameters
20-byte address to check balance for
Block number in hex, or "latest", "earliest", "pending", "safe", "finalized"
Response Body
Integer of the current balance in wei (hexadecimal)
Code Examples
curl -X POST https://api-tempo-mainnet.n.dwellir.com/YOUR_API_KEY \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0x0bd34b0a5be345c9bf7a147eb698e993511180cb",
"latest"
],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | Invalid address format or block parameter |
| -32000 | Execution error | Node execution error |
Related Methods
eth_getCode- Get contract bytecodeeth_getTransactionCount- Get account nonce
eth_getBlockReceipts
Return every transaction receipt in a block on Tempo. Useful for indexers, analytics pipelines, and event backfills across merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.
eth_getCode
Get contract bytecode on Tempo. Essential for verifying smart contracts for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.