TON DocsTON Docs
OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Lookup block

POST
/api/v2/lookupBlock

Finds a block by position or time. Specify workchain and shard, then provide exactly one of: seqno (exact block number), lt (find block containing this logical time), or unixtime (find block closest to this timestamp). Returns the full block ID including hashes needed for verification.

Authorization

X-API-Key<token>

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.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request to find a block by workchain, shard, and either seqno, lt, or unixtime.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v2/lookupBlock" \  -H "Content-Type: application/json" \  -d '{    "workchain": "string",    "shard": "string"  }'
{  "ok": true,  "result": {    "@type": "ton.blockIdExt",    "workchain": 0,    "shard": "string",    "seqno": 0,    "root_hash": "string",    "file_hash": "string"  },  "@extra": "string"}