TON CenterAPI referenceBlocks
Lookup block
Find a block by position or time.
Query Parameters
workchain*integer
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.
Format
int32shard*string
The shard identifier. Masterchain always uses -9223372036854775808. For basechain, shards split and merge dynamically. Use the shards endpoint to discover current shard configuration.
seqno?integer
Block sequence number to look up. Provide this, lt, or unixtime to identify the block. If omitted, returns the current block.
Format
int32lt?string
Logical time of a block
unixtime?integer
UNIX timestamp of a block
Format
int32Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/lookupBlock?workchain=0&shard=8000000000000000&seqno=73082262"{
"ok": true,
"result": {
"@type": "ton.blockIdExt",
"workchain": 0,
"shard": "string",
"seqno": 0,
"root_hash": "string",
"file_hash": "string"
},
"@extra": "string"
}{
"ok": false,
"code": 401,
"error": "API key does not exist"
}{
"ok": false,
"code": 403,
"error": "Network not allowed"
}{
"ok": false,
"code": 422,
"error": "failed to parse workchain"
}{
"ok": false,
"code": 429,
"error": "Ratelimit exceeded"
}{
"ok": false,
"code": 504,
"error": "LITE_SERVER_NETWORK timeout"
}Last updated on