eth_getBlockByNumber - TRON RPC Method
Retrieve complete block data by block number on TRON. Perfect 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.
Returns information about a block by block number 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_getBlockByNumber method is essential for:
- Block explorers - Display complete block information
- Transaction indexers - Process all transactions in a block
- Analytics platforms - Analyze blockchain data for TRC-20 transfers, wallet operations, and EVM-compatible smart contract integrations
- Timestamp verification - Get block timestamps for time-based logic
Request Parameters
Block number in hex, or "latest", "earliest", "pending", "safe", "finalized"
If true, returns full transaction objects; if false, returns transaction hashes
Response Body
Block number
32-byte block hash
32-byte parent block hash
Unix timestamp
Total gas used by all transactions
Maximum gas allowed in block
Array of transaction objects or hashes
Base fee per gas (EIP-1559)
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_getBlockByNumber",
"params": ["latest", false],
"id": 1
}'Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | Invalid block number or parameter format |
| -32000 | Block not found | Block does not exist |
Related Methods
eth_blockNumber- Get latest block numbereth_getBlockByHash- Get block by hasheth_getTransactionByHash- Get transaction details
eth_blockNumber
Get the current block height on TRON. Essential for syncing dApps, monitoring transaction confirmations, and blockchain state tracking.
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.