Skip to main content

GetBlockByNum gRPC Method

Retrieves a specific block by its block number from the TRON network

Updated on
May 13, 2025

GetBlockByNum gRPC Method

Parameters

num
integer
REQUIRED
The block number

Returns

transactions
array
List of transactions in the current block
transaction
object
Transaction details
raw_data
object
Raw transaction data
refBlockBytes
string
Reference block bytes
refBlockNum
integer
Reference block number
refBlockHash
string
Reference block hash
expiration
integer
Transaction expiration timestamp
auths
array
Authorization details
data
string
Transaction data
contract
array
List of contracts in the transaction
scripts
string
Transaction scripts
timestamp
integer
Transaction timestamp
feeLimit
integer
Maximum fee limit for the transaction
signature
array
Transaction signatures
ret
array
Transaction execution results
txid
string
Transaction ID (hash of transaction.rowdata)
constant_result
array
Results from constant function calls
result
object
Transaction result status
result
boolean
Whether the transaction was successful
code
string
Result code
message
string
Result message
energy_used
integer
Amount of energy used by the transaction
logs
array
Event logs generated during transaction execution
address
string
Contract address that generated the log
topics
array
Indexed log topics
data
string
Log data
internal_transactions
array
Internal transactions within a smart contract
hash
string
Internal transaction hash
caller_address
string
Caller address
transferTo_address
string
Recipient address
callValueInfo
array
Value transfer information
callValue
integer
Value being transferred
tokenId
string
ID of the token (empty for TRX)
note
string
Additional notes
rejected
boolean
Whether the transaction was rejected
extra
string
Extra information
energy_penalty
integer
Energy penalty applied to the transaction
block_header
object
Header information of the current block
raw_data
object
Raw block header data
timestamp
integer
Block creation timestamp
txTrieRoot
string
Merkle root of transactions
parentHash
string
Hash of the parent block
number
integer
Block height
witness_id
integer
ID of the witness that produced the block
witness_address
string
Address of the witness that produced the block
version
integer
Block version
accountStateRoot
string
Root hash of account state
witness_signature
string
Signature of the witness
blockid
string
The ID (hash) of the block
Request
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free