TONTONDocs
TON CenterV3Blockchain data

applications/api/toncenter/v3/blockchain-data/get-blocks

GET
/api/v3/blocks

Query Parameters

workchain?integer

Block workchain.

Formatint32
shard?string

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

seqno?integer

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

Formatint32
root_hash?string

Block root hash.

file_hash?string

Block file hash.

mc_seqno?integer

Masterchain block seqno

Formatint32
start_utime?integer

Query blocks with generation UTC timestamp after given timestamp.

Formatint32
Range0 <= value
end_utime?integer

Query blocks with generation UTC timestamp before given timestamp.

Formatint32
Range0 <= value
start_lt?integer

Query blocks with lt >= start_lt.

Formatint64
Range0 <= value
end_lt?integer

Query blocks with lt <= end_lt.

Formatint64
Range0 <= value
limit?integer

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

Default10
Formatint32
Range1 <= value <= 1000
offset?integer

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

Default0
Formatint32
Range0 <= value
sort?string

Sort results by UTC timestamp.

Default"desc"
Value in"asc" | "desc"

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v3/blocks"
{
  "blocks": [
    {
      "after_merge": true,
      "after_split": true,
      "before_split": true,
      "created_by": "string",
      "end_lt": "0",
      "file_hash": "string",
      "flags": 0,
      "gen_catchain_seqno": 0,
      "gen_utime": "0",
      "global_id": 0,
      "key_block": true,
      "master_ref_seqno": 0,
      "masterchain_block_ref": {
        "seqno": 0,
        "shard": "0",
        "workchain": 0
      },
      "min_ref_mc_seqno": 0,
      "prev_blocks": [
        {
          "seqno": 0,
          "shard": "0",
          "workchain": 0
        }
      ],
      "prev_key_block_seqno": 0,
      "rand_seed": "string",
      "root_hash": "string",
      "seqno": 0,
      "shard": "0",
      "start_lt": "0",
      "tx_count": 0,
      "validator_list_hash_short": 0,
      "version": 0,
      "vert_seqno": 0,
      "vert_seqno_incr": true,
      "want_merge": true,
      "want_split": true,
      "workchain": 0
    }
  ]
}
{
  "code": 0,
  "error": "string"
}

Last updated on