Skip to main content
GET
/
masterchainBlockShardState
Get Masterchain Block Shard State
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/masterchainBlockShardState
{
  "shards": [
    {
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    }
  ]
}
The masterchainBlockShardState method retrieves the shard state of a specific masterchain block in the TON blockchain. This method provides information about the shards associated with the given masterchain block.
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 or archive by block ageThis method is billed as archive (2 RUs) when the requested block is 128 or more seqno behind the tip, and full (1 RU) otherwise. See Request units — TON method scope.

​
Parameters

  • seqno (integer, required) — The sequence number of the masterchain block. Example: 40467413.

​
Response

  • shards (array) — An array of shard objects, each containing:
    • workchain (integer) — The workchain ID.
    • shard (string) — The shard identifier.
    • seqno (integer) — The sequence number of the shard block.
    • root_hash (string) — The root hash of the shard block.
    • file_hash (string) — The file hash of the shard block.

​
Use case

The masterchainBlockShardState method is useful for applications that need to analyze or track the state of shards within the TON blockchain. This information can be valuable for:
  1. Blockchain explorers that want to display detailed information about the structure of the TON blockchain.
  2. Analytics tools that need to monitor the distribution of shards across workchains.
  3. Developers building applications that require knowledge of the current state of shards for optimization or routing purposes.

Query Parameters

​
seqno
integer
default:40467413
required

The sequence number of the masterchain block

Example:

40467413

Response

200 - application/json

Successful response

​
shards
object[]
Last modified on June 4, 2026