Get Blocks

GET

https://ton-index.nownodes.io/api/v3/blocks

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns blocks by specified filters.

Parameters

workchainintegerquery

Block workchain.

shardstringquery

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

seqnointegerquery

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

start_utimeintegerquery

Query blocks with generation UTC timestamp after given timestamp.

end_utimeintegerquery

Query blocks with generation UTC timestamp before given timestamp

start_ltintegerquery

Query blocks with lt >= start_lt

end_ltintegerquery

Query blocks with lt <= end_lt

limitinteger[1, 256]128query

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

offsetinteger>= 00query

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

sortstringascdescdescquery

Sort results by UTC timestamp.

Response

200OK

Successful Response

422Unprocessable Entity

Validation Error

Get Blocks

curl -X GET 'https://ton-index.nownodes.io/api/v3/blocks'

const response = await fetch('https://ton-index.nownodes.io/api/v3/blocks', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ton-index.nownodes.io/api/v3/blocks')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://ton-index.nownodes.io/api/v3/blocks')
data = response.json()

const response = await fetch('https://ton-index.nownodes.io/api/v3/blocks', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ton-index.nownodes.io/api/v3/blocks";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://ton-index.nownodes.io/api/v3/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ton-index.nownodes.io/api/v3/blocks')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ton-index.nownodes.io/api/v3/blocks')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "blocks": [
    {
      "workchain": 0,
      "shard": "string",
      "seqno": 0,
      "root_hash": "string",
      "file_hash": "string",
      "global_id": 0,
      "version": 0,
      "after_merge": true,
      "before_split": true,
      "after_split": true,
      "want_merge": true,
      "want_split": true,
      "key_block": true,
      "vert_seqno_incr": true,
      "flags": 0,
      "gen_utime": "string",
      "start_lt": "string",
      "end_lt": "string",
      "validator_list_hash_short": 0,
      "gen_catchain_seqno": 0,
      "min_ref_mc_seqno": 0,
      "prev_key_block_seqno": 0,
      "vert_seqno": 0,
      "master_ref_seqno": 0,
      "rand_seed": "string",
      "created_by": "string",
      "tx_count": 0,
      "masterchain_block_ref": {
        "workchain": 0,
        "shard": "string",
        "seqno": 0
      },
      "prev_blocks": [
        {
          "workchain": 0,
          "shard": "string",
          "seqno": 0
        }
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}