GET
/
masterchainBlockShards
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 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.
    • 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[]