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 your API key. Requests without a key are limited to 1 RPS. More info here.

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 you can pass in the request and receive back in the response. Useful for matching async responses.