Lookup block
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.
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"}