Get Blocks

Overview

The Get Blocks endpoint obtains data for multiple blocks by specifying their range, which should be defined either by block_number_start and block_number_end, timestamp_start and timestamp_end, or block_hash. When querying via block_hash, pass it as a path parameter.

Querying via Postman

If you prefer querying via Postman, the description of PARSIQ Endpoints for Get Block by Range (opens in a new tab) or Get Blocks by Hash (opens in a new tab) might come in handy. There you will find examples and responses for good and bad requests as well as parameter definitions and their example values.

Usage

In this example, we receive data for the last 10,000 blocks on Ethereum Mainnet.

import * as Parsiq from '@parsiq/parsiq.js';
 
const client = Parsiq.createClient(process.env.API_KEY, Parsiq.ChainId.ETH_MAINNET);
 
const blocks = client.blocks.getByBlockRange(
    -10000, 'latest',
    {
      limit: 1
    }
);
 
for await (const block of blocks) {
    console.log(block);
}

Output:

{
  hash: '0x67d2cc2cf7811c0e709d98cf5d84b5be0ab0eeefeb2680f8b5388fccfb50e974',
  parent_hash: '0xbb3c9df37b5c83200b5e5a9e9237147ca011985e9e80d6b41c5e47d636595786',
  number: 18372585,
  timestamp: 1697575823,
  header: {
    nonce: 0,
    gas_used: 15006326,
    mix_hash: '0x4f1e7823297ddc6e5a7291f326d453a536b168245fb2c8b39fe5a562a71ff3fe',
    gas_limit: 29970705,
    burnt_fees: '192534599088679304',
    difficulty: 0,
    extra_data: '0x6265617665726275696c642e6f7267',
    logs_bloom: '0x31b561ab41c13a13523071c9ac577033c455c85b0cd3405042bb3424ad7219168006d1b9c17801ba6a495b2ba542774a4631a1749e842ec21439e72c912b74cc8ac4ea58006c8aebda0e446e5d60b9618ef9b690c0442cf0454b7ca080b2d1795b5924c05e0f82448193708559c27c7d3e02a93c18ba7e890754569e77c9a9ce010583f0680788b9014424d508ac1b2266c02499e95624c9ec30216c76111e119ba88d050b6fbe7aba2be7cf9d52471ec762a68020799246e97e14aa943a5e30e1d9ad870746c5010217ba73f3de60cd71697270468d2498213d602b54d13826d9fa3698485c299f849e97f5ab012d68482df0a07b0a71ce1e8990950ac95cff',
    state_root: '0x625f2fb976b92df32cf535e5c95fe6f809ec5366073ec45e2d63fe06fb70df31',
    sha3_uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347',
    receipts_root: '0xfcc861b112514a0338a331f16f93d0e4976e98035865d17bf45721bff53d81c1',
    base_fee_per_gas: '12830229004',
    total_difficulty: '58750003716598360000000',
    transactions_root: '0xaab0748d0a17df672565a848e107588d0a2f164a5339e59d25270f8245316909'
  },
  ghost: true
}

Parameters

Path params

chainId

string

REQUIRED

version

string

REQUIRED

Query params

block_number_start

number

REQUIRED

block_number_end

string

number

REQUIRED

offset

string

limit

number

estimate_cu

boolean

Get Latest Block Overview