Skip to main content
GET
/
api
/
v2
/
lookupBlock
Lookup Block
curl --request GET \
  --url https://toncenter.com/api/v2/lookupBlock
{
  "ok": true,
  "result": {
    "@type": "ton.blockIdExt",
    "workchain": 123,
    "shard": "<string>",
    "seqno": 123,
    "root_hash": "<string>",
    "file_hash": "<string>"
  }
}

SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

WORKCHAIN = 0
SHARD = "-9223372036854775808"
SEQNO = 49560770


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v2.blocks.lookup_block(
            WORKCHAIN,
            SHARD,
            seqno=SEQNO,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

workchain
integer<int32>
required

Workchain ID

shard
string
required

Shard ID

seqno
integer<int32>

Seqno of a block

lt
string

Logical time of a block

unixtime
integer<int32>

UNIX timestamp of a block

Response

OK

ok
boolean
required
Example:

true

result
TonBlockIdExt · object
required

Extended block identifier.