Get shards

Returns the active shardchain block identifiers at a given masterchain block height. Each shard processes a subset of accounts in parallel. The response shows how the basechain is currently partitioned and which block each shard is at.

GET /api/v2/getShards

Get shards

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getShards \
  --header 'X-API-Key: <api-key>'

200

{
  "ok": true,
  "result": {},
  "@extra": "<string>",
  "jsonrpc": "<string>",
  "id": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

Query Parameters

seqno · integer<int32> · required

Seqno of masterchain block

Response

200

application/json

Returns the list of active shard block identifiers at the specified masterchain block.

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

The method return value. The structure depends on the method called; see individual method documentation for response schemas. Only present when ok is true.

@extra · string · required

Optional request ID that can be passed in the request and received back in the response. Useful for matching async responses.

jsonrpc · string

JSON-RPC protocol version identifier.

id · string

Echoed request identifier from the original JSON-RPC request.