masterchainInfo - Ton

masterchainInfo. Retrieves information about the current state of the masterchain

masterchainInfo - ton [Value: 100CU]
Retrieves the sizes of outgoing message queues for specified addresses, providing insights into message processing and network load.
Use cases

Use cases

  • Retrieve information about the TON masterchain
  • Analyze masterchain status and metrics
  • Audit masterchain properties
Constraints

Constraints

  • Requires a synced node for accurate data
  • Supports Masterchain Info V3 only
  • Depends on network connectivity
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
     --url  'https://ton.drpc.org/rest/api/v3/masterchainInfo' \
     --header 'accept: application/json'
Copy
Response
200
{
    "ok": true,
    "result": {
        "last_seqno": 40467413,
        "last_block_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
        "last_block_time": 1693527600,
        "masterchain_info": {
            "total_blocks": 500000,
            "total_transactions": 1500000,
            "block_time": 5,
            "average_transaction_size": 200,
            "root_hash": "abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef"
        }
    }
}
Copy

Request params

ParametersThis method does not accept any parameters.

Response

200

Response params

object
okboolean
Indicates if the request was successful.
resultobject
Details of the blockchain state.
object
last_seqnointeger
Sequence number of the last block in the masterchain.
last_block_idstring
Unique identifier of the last block.
last_block_timeinteger
Unix timestamp of when the last block was created.
masterchain_infoobject
Information about the masterchain.
object
total_blocksinteger
Total number of blocks in the masterchain.
total_transactionsinteger
Total number of transactions processed in the masterchain.
block_timeinteger
Average time taken to create a block, in seconds.
average_transaction_sizeinteger
Average size of transactions in bytes.
root_hashstring
Root hash of the masterchain state.
getOutMsgQueueSizesAccount info