Get masterchain info

Returns the current state of the TON masterchain. The last field contains the latest block, which you’ll need for querying current state. The seqno in last is the current block height. Call this first to get the latest block reference for other queries.

POST /api/v2/getMasterchainInfo

Try it

Get masterchain info

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getMasterchainInfo \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

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

X-API-Key · string · header · required

Body

application/json

Empty request body for endpoints that require no parameters.

Response

200

application/json

OK

Response containing current masterchain state and latest block.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: blocks.masterchainInfo · required

Object type identifier.

Available options: blocks.masterchainInfo

result. last · object · required

The most recent masterchain block.

Show child attributes

result.last. @type · enum<string> · default: ton.blockIdExt · required

Object type identifier.

Available options: ton.blockIdExt

result.last. workchain · integer · required

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

result.last. shard · string · required

Shard identifier. A signed 64-bit integer. Masterchain uses -9223372036854775808.

result.last. seqno · integer · required

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

result.last. root_hash · string · required

Merkle root hash of the block state tree. Used for cryptographic verification.

result.last. file_hash · string · required

Hash of the serialized block data. Together with root_hash, uniquely identifies a block.

result. state_root_hash · string · required

Merkle root of the entire blockchain state at this block.

result. init · object · required

The genesis (first) block.

Show child attributes

result.init. @type · enum<string> · default: ton.blockIdExt · required

Object type identifier.

Available options: ton.blockIdExt

result.init. workchain · integer · required

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

result.init. shard · string · required

Shard identifier. A signed 64-bit integer. Masterchain uses -9223372036854775808.

result.init. seqno · integer · required

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

result.init. root_hash · string · required

Merkle root hash of the block state tree. Used for cryptographic verification.

result.init. file_hash · string · required

Hash of the serialized block data. Together with root_hash, uniquely identifies a block.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.