blocks

Lookup Block

Finds a block by position or time. Specify workchain and shard, then provide exactly one of seqno (block sequence number), lt (logical time), or unixtime (Unix timestamp). Returns the full block identifier including hashes.

get/api/v2/lookupBlock

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/lookupBlock
  • 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

Query state at a specific block height. If omitted, returns the current state. Use this to look up historical data at a specific point in time.

ltstring

Logical time of a block

unixtimeinteger

UNIX timestamp of a block

Response

Returns the full block identifier matching the given seqno, logical time, or unix timestamp.

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.