Query Parameters

workchain

integer

The workchain identifier

shard

string

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

seqno

integer

Block block seqno. Must be sent with workchain and shard

mc_seqno

integer

Masterchain block seqno

start_utime

integer

Query blocks with generation UTC timestamp after given timestamp

end_utime

integer

Query blocks with generation UTC timestamp before given timestamp

start_lt

integer

Query blocks with lt >= start_lt

end_lt

integer

Query blocks with lt <= end_lt

limit

integer

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

offset

integer

Skip first N rows. Use with limit to batch read

sort

string

Sort results by UTC timestamp

Returns

blocks

array

The array of block objects

workchain

integer

The workchain identifier

shard

string

The shard identifier

seqno

integer

The block sequence number

root_hash

string

The root hash of the block

file_hash

string

The hash of the block file

global_id

integer

The global identifier of the blockchain

version

integer

The block version

after_merge

boolean

The indicator if this block was created after a merge operation

before_split

boolean

The indicator if this block was created before a split operation

after_split

boolean

The indicator if this block was created after a split operation

want_merge

boolean

The indicator if the block wants to merge

want_split

boolean

The indicator if the block wants to split

key_block

boolean

The indicator if this is a key block

vert_seqno_incr

boolean

The indicator if vertical sequence number was incremented

flags

integer

The block flags indicating various properties

gen_utime

string

The block generation UTC timestamp

start_lt

string

The start logical time of the block

end_lt

string

The end logical time of the block

validator_list_hash_short

integer

The short hash of the validator list

gen_catchain_seqno

integer

The generation catchain sequence number

min_ref_mc_seqno

integer

The minimum referenced masterchain sequence number

prev_key_block_seqno

integer

The sequence number of the previous key block

vert_seqno

integer

The vertical sequence number

master_ref_seqno

integer

The sequence number of the referenced masterchain block

rand_seed

string

The random seed used in block generation

created_by

string

The address of the validator that created this block

tx_count

integer

The number of transactions in the block

masterchain_block_ref

object

The reference to the masterchain block

workchain

integer

The workchain identifier of the masterchain block

shard

string

The shard identifier of the masterchain block

seqno

integer

The sequence number of the masterchain block

prev_blocks

array

The array of previous block references

workchain

integer

The workchain identifier of the previous block

shard

string

The shard identifier of the previous block

seqno

integer

The sequence number of the previous block

Request

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1' \
2
--header 'accept: application/json'

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1' \
2
--header 'accept: application/json'

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1", requestOptions)

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
    method: "GET",
6
    headers: myHeaders,
7
    redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1", requestOptions)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1"
4

5
payload = {}
6
headers = {
7
    'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/v3/blocks?workchain=-1")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free