Skip to main content
GET
/
getMasterchainInfo
getMasterchainInfo
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/getMasterchainInfo
{
  "last": {
    "seqno": 123,
    "shard": "<string>",
    "workchain": 123,
    "fileHash": "<string>",
    "rootHash": "<string>"
  },
  "init": {
    "fileHash": "<string>",
    "rootHash": "<string>"
  },
  "stateRootHash": "<string>",
  "version": 123
}
The getMasterchainInfo method retrieves information about the current state of the TON masterchain. This method provides crucial details about the latest masterchain block and the initial state of the masterchain.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
TON billing: full (1 RU)This method is always billed as full. See Request units — TON method scope.

​
Parameters

This method doesn’t require any parameters.

​
JSON-RPC example

Shell
curl -X POST \
  'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v2/jsonRPC' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMasterchainInfo",
    "params": {}
  }'

​
Response

  • last (object) — Information about the last masterchain block:
    • seqno (integer) — The sequence number of the last masterchain block.
    • shard (string) — The shard identifier of the last masterchain block.
    • workchain (integer) — The workchain identifier of the last masterchain block.
    • fileHash (string) — The file hash of the last masterchain block.
    • rootHash (string) — The root hash of the last masterchain block.
  • init (object) — Information about the initial masterchain block:
    • fileHash (string) — The file hash of the initial masterchain block.
    • rootHash (string) — The root hash of the initial masterchain block.
  • stateRootHash (string) — The state root hash of the masterchain.
  • version (integer) — The version of the masterchain.

​
Use case

A possible use case for the getMasterchainInfo method in TON is for applications that need to monitor or sync with the current state of the TON blockchain. This method can be used to:
  1. Track the latest block in the masterchain for synchronization purposes.
  2. Verify the current state of the blockchain against a known state.
  3. Monitor the progress of the masterchain in terms of block sequence numbers.
  4. Obtain necessary information for validating and processing transactions.

Response

200 - application/json

Information about the current state of the TON masterchain

​
last
object
​
init
object
​
stateRootHash
string

The state root hash of the masterchain

​
version
integer

The version of the masterchain

Last modified on June 4, 2026