blocks

Get Block

Get raw block data as a base64-encoded BOC

get/api/v2/getBlock

Request

  • Base URL: https://toncenter.com (the document declares no server; this is the origin it was published from)
  • URL: https://toncenter.com/api/v2/getBlock
  • Auth: one of:
    • API key in header X-API-Key
    • API key in query parameter api_key

Query parameters

workchaininteger required

The workchain to query. Use -1 for masterchain (validators, system contracts, config) or 0 for basechain (regular accounts and contracts). Most user transactions happen on workchain 0.

shardstring required

The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.

seqnointeger required

Block sequence number within the specified workchain and shard.

root_hashstring

The block's root hash. Together with file_hash, uniquely identifies a block.

file_hashstring

The block's file hash. Together with root_hash, uniquely identifies a block.

archivalboolean

Request data from archival nodes when querying old transactions or historical state.

Response

OK

okboolean required

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

@extrastring required
jsonrpcstring

JSON-RPC protocol version identifier.

idstring

Changes

No recorded changes to this operation across all 1 revision of this API.