Look up block by height, LT, or timestamp

Look up block by either seqno, lt or unixtime.

GET /lookupBlock

Try it

Look up block by height, LT, or timestamp

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/lookupBlock

200

{
  "ok": true,
  "result": {
    "@type": "ton.blockIdExt",
    "workchain": -1,
    "shard": "-9223372036854775808",
    "seqno": 51148869,
    "root_hash": "HxogBiV2YA+KrC9cJa5llfvDGNk2hwCqsaCSYo40V00=",
    "file_hash": "h7LOaX0cTqc8qKecsNYi32SVu0McCito3P2qzynvdqk=",
    "@extra": "1755814026.5747118:7:0.2443600480097572"
  }
}

Query Parameters

workchain · integer · required

Workchain id to look up block in Workchain id to look up block in

shard · integer · required

Shard id to look up block in Shard id to look up block in

seqno · integer

Block's height Block's height

lt · integer

Block's logical time Block's logical time

unixtime · integer

Block's unixtime Block's unixtime

Response

200

application/json

Successful Response

ok · boolean · required

result · Result · object

Block identifier for the looked-up block.

Show child attributes

result. workchain · integer · required

result. shard · string · required

64-bit signed integer as string

result. seqno · integer · required

result. root_hash · string · required

result. file_hash · string · required

result. @type · string

Example:

"ton.blockIdExt"

error · string

code · integer