Get masterchain info

Returns the current state of the TON masterchain. The last field contains the latest block used for querying current state. The seqno in last is the current block height. Use this endpoint to obtain the latest block reference for other queries.

GET /api/v2/getMasterchainInfo

Get masterchain info

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getMasterchainInfo \
  --header 'X-API-Key: <api-key>'

200

{
  "ok": true,
  "result": {
    "@type": "blocks.masterchainInfo",
    "last": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "state_root_hash": "<string>",
    "init": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    }
  },
  "@extra": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

Response

200

application/json

The current masterchain state, including the latest block identifier, its state root hash, and the genesis block reference. Use result.last.seqno as the current block height.

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

Response data. Present only when ok is true.

Show child attributes

@extra · string

Optional request ID that can be passed in the request and received back in the response. Useful for matching async responses.