shards - Ton

shards. Retrieves information about the available shards in the TON blockchain, including their current states and details.

shards - ton [Value: 100CU]
Retrieves information about the available shards in the TON blockchain, including their current states and details.
Use cases

Use cases

  • Get details of available TON shards
  • Monitor shard performance and status
  • Analyze shard distribution across the network
Constraints

Constraints

  • Requires a synced node for accurate info
  • Only active shards are reported
  • Depends on the current network state
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
     --url  'https://ton.drpc.org/rest/shards?seqno=41089440' \
     --header 'accept: application/json'
Copy
Response
200
{
    "ok": true,
    "result": {
        "@type": "blocks.shards",
        "shards": [
            {
                "@type": "ton.blockIdExt",
                "workchain": 0,
                "shard": "2305843009213693952",
                "seqno": 46318027,
                "root_hash": "nDcQoEXk51uIA81rM2kwc/ceQpDxLXj+sQwlm37bbx0=",
                "file_hash": "2xs8ZzUvIMVst2Y4V5wUi3SHmwS057ogEci0XfTTs5U="
            },
            {
                "@type": "ton.blockIdExt",
                "workchain": 0,
                "shard": "6917529027641081856",
                "seqno": 46325559,
                "root_hash": "1/qSS3XGjt9DfTWoprnU9mRTBFOL76mI++06+8qzwQU=",
                "file_hash": "dEi45pexXnnhbZVBz6ABAjlmmC3VDteTjMJ+k5QJIPg="
            },
            {
                "@type": "ton.blockIdExt",
                "workchain": 0,
                "shard": "-6917529027641081856",
                "seqno": 46204566,
                "root_hash": "/LIdp0yNWqiag0UuGVyJ0brkqx20GD2y0ybVzeUFbFA=",
                "file_hash": "ANLBgEkWZIQ4ywmZxLZ/+j5J/6un6dRtCi9I47zQrsI="
            },
            {
                "@type": "ton.blockIdExt",
                "workchain": 0,
                "shard": "-2305843009213693952",
                "seqno": 46311381,
                "root_hash": "arjn0Rzg5a0vJ50pkLQcbXmBa8T0N0yqsocwVtJyXOw=",
                "file_hash": "RSWUebKiSZF3ecC4vyJ2kuQO/EyMQMdlilwq2Ob04To="
            }
        ],
        "@extra": "1730410285.710065:0:0.42444265563423145"
    }
}
Copy

Path params

Parameters

Query params

Parameters

Request params

Parametersinteger
integer
seqnointeger
The sequence number of the block.

Response

200

Response params

object
okboolean
Indicates if the request was successful.
resultobject
Contains the result of the request.
object
@typestring
Type of the result; indicates the response type.
shardsarray
List of shard block identifiers.
object
@typestring
Type of the shard block identifier.
workchaininteger
The workchain ID; 0 indicates the masterchain.
shardstring
The shard ID, represented as a string.
seqnointeger
The sequence number of the block in the shard.
root_hashstring
The root hash of the block.
file_hashstring
The file hash associated with the block.
@extrastring
Additional metadata related to the request.
lookupBlockgetBlockHeader