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 100+ 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

Path params

Parameters

Query params

Parameters

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