qn_getBlocksInTimestampRange RPC Method - Block Timestamp Lookup

Please note that this RPC method requires the Block Timestamp Lookup add-on enabled on your QuickNode endpoint. This method is available for mainnet only.

Parameters

startTimestamp

integer

REQUIRED

endTimestamp

integer

REQUIRED

pageSize

integer

lastTimestamp

integer

lastBlockNumber

integer

Returns

result

object

blocks

array

blockNumber

integer

network

string

timestamp

integer

pagination

object

hasNextPage

boolean

nextPageParams

object

lastBlockNumber

integer

lastTimestamp

integer

pageSize

integer

Request

curl --location 'https://docs-demo.quiknode.pro/' \
--header 'Content-Type: application/json' \
--data '{
  "method": "qn_getBlocksInTimestampRange",
  "params": {
    "startTimestamp": 1730000000,
    "endTimestamp": 1730000100,
    "pageSize": 5
  }
}'

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "method": "qn_getBlocksInTimestampRange",
  "params": {
    "startTimestamp": 1730000000,
    "endTimestamp": 1730000100,
    "pageSize": 5
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://docs-demo.quiknode.pro/", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

import requests
import json

url = "https://docs-demo.quiknode.pro/"

payload = json.dumps({
  "method": "qn_getBlocksInTimestampRange",
  "params": {
    "startTimestamp": 1730000000,
    "endTimestamp": 1730000100,
    "pageSize": 5
  }
})
headers = {
  'Content-Type': 'application/json'
}

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

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "qn_getBlocksInTimestampRange",
  "params": {
    "startTimestamp": 1730000000,
    "endTimestamp": 1730000100,
    "pageSize": 5
  }
})

response = https.request(request)
puts response.read_body

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blocks": [
      {
        "blockNumber": 29402654,
        "network": "ethereum",
        "timestamp": 1730000000
      },
      {
        "blockNumber": 29402655,
        "network": "ethereum",
        "timestamp": 1730000012
      },
      {
        "blockNumber": 29402656,
        "network": "ethereum",
        "timestamp": 1730000024
      },
      {
        "blockNumber": 29402657,
        "network": "ethereum",
        "timestamp": 1730000036
      },
      {
        "blockNumber": 29402658,
        "network": "ethereum",
        "timestamp": 1730000048
      }
    ],
    "pagination": {
      "hasNextPage": true,
      "nextPageParams": {
        "lastBlockNumber": 29402658,
        "lastTimestamp": 1730000048,
        "pageSize": 5
      }
    }
  }
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

qn_getBlocksInTimestampRange RPC Method - Block Timestamp Lookup

Loading...

Parameters

Returns