/walletsolidity/getblockbyid - Tron

Example code for the getblockbyid Solidity API method. Complete guide on how to use getblockbyid Solidity API method in GetBlock Web3 documentation.

This endpoint returns a block by its hash. It reads only confirmed data from the Solidity node.

This is a Solidity-node endpoint. It returns only confirmed, irreversible data, so it is the correct interface for balance and payment verification. The Fullnode serves the same operation at https://go.getblock.io/<ACCESS-TOKEN>/wallet/getblockbyid over the latest, possibly unconfirmed state.

Parameters

Parameter	Type	Required	Description
value	string	Yes	The block hash (block id)

Request

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/walletsolidity/getblockbyid' \
--header 'Content-Type: application/json' \
--data-raw '{
  "value": "0000000002f3a5b0f6d2e6c9a1b4e7f0a3b6c9d2e5f8a1b4c7d0e3f6a9b2c5d8"
}'

JavaScript

example.js

const response = await fetch(
    'https://go.getblock.io/<ACCESS-TOKEN>/walletsolidity/getblockbyid',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({"value": "0000000002f3a5b0f6d2e6c9a1b4e7f0a3b6c9d2e5f8a1b4c7d0e3f6a9b2c5d8"})
    }
);
console.log(await response.json());

Python

example.py

import requests

response = requests.post(
    'https://go.getblock.io/<ACCESS-TOKEN>/walletsolidity/getblockbyid',
    headers={'Content-Type': 'application/json'},
    json={"value": "0000000002f3a5b0f6d2e6c9a1b4e7f0a3b6c9d2e5f8a1b4c7d0e3f6a9b2c5d8"}
)

print(response.json())

Response

{
  "blockID": "0000000002f3a5b0f6d2e6c9a1b4e7f0a3b6c9d2e5f8a1b4c7d0e3f6a9b2c5d8",
  "block_header": {
    "raw_data": {
      "number": 68000000,
      "timestamp": 1719400000000,
      "witness_address": "41e72d833e0c46837c0802864acc5f119a0a904d05"
    }
  },
  "transactions": [
    {
      "txID": "d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62"
    }
  ]
}

Response Parameters

Field	Type	Description
blockID	string	The block hash
block_header.raw_data.number	integer	Block height
block_header.raw_data.timestamp	integer	Block time in milliseconds
transactions	array	Transactions included in the block

Use Cases

• Hash Lookups: Fetch a confirmed block by its hash

• Verification: Confirm a block's contents against its hash

• Explorer Links: Resolve a block-hash link to block detail

• Reorg-Safe Reads: Read a block that is final and irreversible

Error Handling

HTTP Status	Message	Description
200	OK	The request succeeded; some TRON errors are returned in the 200 body as an Error field
400	Bad request	The request body is malformed or a required field is missing
500	Internal error	The node failed to process the request