GET
/
masterchainBlockShardState
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 you own node endpoint today

Start 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 pricing is the same for full, archive, v2, v3

There’s no difference between a full node an archive node in data availability or pricing.
All data is always available and all node requests are consumed as 1 request unit.

​
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[]