Skip to main content
GET
/
api
/
v3
/
blocks
Get blocks
curl --request GET \
  --url https://toncenter.com/api/v3/blocks
{
  "blocks": [
    {
      "after_merge": true,
      "after_split": true,
      "before_split": true,
      "created_by": "<string>",
      "end_lt": "0",
      "file_hash": "<string>",
      "flags": 123,
      "gen_catchain_seqno": 123,
      "gen_utime": "0",
      "global_id": 123,
      "key_block": true,
      "master_ref_seqno": 123,
      "masterchain_block_ref": {
        "seqno": 123,
        "shard": "0",
        "workchain": 123
      },
      "min_ref_mc_seqno": 123,
      "prev_blocks": [
        {
          "seqno": 123,
          "shard": "0",
          "workchain": 123
        }
      ],
      "prev_key_block_seqno": 123,
      "rand_seed": "<string>",
      "root_hash": "<string>",
      "seqno": 123,
      "shard": "0",
      "start_lt": "0",
      "tx_count": 123,
      "validator_list_hash_short": 123,
      "version": 123,
      "vert_seqno": 123,
      "vert_seqno_incr": true,
      "want_merge": true,
      "want_split": true,
      "workchain": 123
    }
  ]
}

Query Parameters

​
workchain
integer<int32>

Block workchain.

​
shard
string

Block shard id. Must be sent with workchain. Example: 8000000000000000.

​
seqno
integer<int32>

Block block seqno. Must be sent with workchain and shard.

​
root_hash
string

Block root hash.

​
file_hash
string

Block file hash.

​
mc_seqno
integer<int32>

Masterchain block seqno

​
start_utime
integer<int32>

Query blocks with generation UTC timestamp after given timestamp.

Required range: x >= 0
​
end_utime
integer<int32>

Query blocks with generation UTC timestamp before given timestamp.

Required range: x >= 0
​
start_lt
integer<int64>

Query blocks with lt >= start_lt.

Required range: x >= 0
​
end_lt
integer<int64>

Query blocks with lt <= end_lt.

Required range: x >= 0
​
limit
integer<int32>
default:10

Limit number of queried rows. Use with offset to batch read.

Required range: 1 <= x <= 1000
​
offset
integer<int32>
default:0

Skip first N rows. Use with limit to batch read.

Required range: x >= 0
​
sort
enum<string>
default:desc

Sort results by UTC timestamp.

Available options:
asc,
desc

Response

200 - application/json

Matching blocks with full metadata.

Response wrapper containing a list of blocks matching the query filters.

​
blocks
object[]

Array of blocks matching the query filters.