eth_getBalance - TRON RPC Method
Query account balance on TRON. Essential for wallet applications and TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations on the TVM-compatible Layer 1 for TRC-20 payments, wallet APIs, and low-cost smart contract execution.
Returns the balance of a given address on TRON.
Why TRON? Build on the TVM-compatible Layer 1 for TRC-20 payments, wallet APIs, and low-cost smart contract execution with TVM compatibility paired with native TRON wallet APIs, DPoS block production, and low-cost transaction flows.
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 TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations
- 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-tron-mainnet.n.dwellir.com/YOUR_API_KEY/jsonrpc \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "eth_getBalance",
"params": [
"0xc7885b2334355ba766f54a3ad14d5a5339934bb3",
"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_getBlockByHash
Retrieve complete block data by block hash on TRON. Essential for TRON developers building payment rails, exchanges, and consumer crypto applications building on the TVM-compatible Layer 1 for TRC-20 payments, wallet APIs, and low-cost smart contract execution.
eth_getCode
Get contract bytecode on TRON. Essential for verifying smart contracts for TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations.