Skip to main content
GET
/
masterchainBlockShards
Get Masterchain Block Shards
curl --request GET \
  --url https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/masterchainBlockShards
{
  "shards": [
    {
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "rootHash": "<string>",
      "fileHash": "<string>"
    }
  ]
}
The masterchainBlockShards endpoint retrieves information about the shards of a specific masterchain block in the TON blockchain.
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.
    • rootHash (string) — The root hash of the shard block.
    • fileHash (string) — The file hash of the shard block.

​
Use case

The masterchainBlockShards endpoint is useful for applications that need to analyze or track the state of shards within a specific masterchain block. This information can be valuable for:
  1. Blockchain explorers that want to display detailed information about the structure of the TON blockchain at a specific point.
  2. Analytics tools that need to monitor the distribution and state of shards across workchains for a given masterchain block.
  3. Developers building applications that require knowledge of the shard structure for optimization or routing purposes.

Query Parameters

​
seqno
integer
default:40467413
required

The sequence number of the masterchain block

Response

200 - application/json

Successful response

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