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

The Unix timestamp (in seconds) marking the start of the desired time range

endTimestamp

integer

REQUIRED

The Unix timestamp (in seconds) marking the end of the desired time range

pageSize

integer

(Optional) Defines how many blocks to return per page. The default value is 100, with a maximum of 1000

lastTimestamp

integer

(Optional) The timestamp of the last block from the previous page, used to paginate through large result sets

lastBlockNumber

integer

(Optional) The block number of the last block from the previous page, used in conjunction with lastTimestamp for pagination

Returns

result

object

The result object which contains the following fields:

blocks

array

An array that contains the list of block objects that fall within the specified timestamp range. Each object represents a block and contains the following fields:

blockNumber

integer

The unique number of the block on the blockchain

network

string

The blockchain network on which the block exists

timestamp

integer

The Unix timestamp (in seconds) representing when the block was created

pagination

object

The pagination object which contains the following fields:

hasNextPage

boolean

A boolean value that indicates whether there are more pages of results to retrieve. If true, it means there are additional blocks that fall within the specified timestamp range but were not included in the current response due to the pageSize limit

nextPageParams

object

The nextPageParams object which contains the following fields:

lastBlockNumber

integer

The block number of the last block in the current page

lastTimestamp

integer

The timestamp of the last block in the current page

pageSize

integer

The number of blocks that were returned in the current response

Request

1
curl -X POST "https://docs-demo.base-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "qn_getBlocksInTimestampRange",
6
  "params": {
7
    "startTimestamp": 1730000000,
8
    "endTimestamp": 1730000100,
9
    "pageSize": 5
10
  },
11
  "id": 1
12
}'

1
curl -X POST "https://docs-demo.base-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "qn_getBlocksInTimestampRange",
6
  "params": {
7
    "startTimestamp": 1730000000,
8
    "endTimestamp": 1730000100,
9
    "pageSize": 5
10
  },
11
  "id": 1
12
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.base-mainnet.quiknode.pro/");
5
    const response = await provider.send("qn_getBlocksInTimestampRange", {
6
    "startTimestamp": 1730000000,
7
    "endTimestamp": 1730000100,
8
    "pageSize": 5
9
});
10
    console.log(response);
11
}
12

13
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.base-mainnet.quiknode.pro/");
5
    const response = await provider.send("qn_getBlocksInTimestampRange", {
6
    "startTimestamp": 1730000000,
7
    "endTimestamp": 1730000100,
8
    "pageSize": 5
9
});
10
    console.log(response);
11
}
12

13
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.base-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("qn_getBlocksInTimestampRange", {"startTimestamp":1730000000,"endTimestamp":1730000100,"pageSize":5})
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.base-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("qn_getBlocksInTimestampRange", {"startTimestamp":1730000000,"endTimestamp":1730000100,"pageSize":5})
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.base-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'qn_getBlocksInTimestampRange',
10
        params: {
11
          "startTimestamp": 1730000000,
12
          "endTimestamp": 1730000100,
13
          "pageSize": 5
14
        }
15
    })
16

17
    console.log(result)
18
}
19

20
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.base-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'qn_getBlocksInTimestampRange',
10
        params: {
11
          "startTimestamp": 1730000000,
12
          "endTimestamp": 1730000100,
13
          "pageSize": 5
14
        }
15
    })
16

17
    console.log(result)
18
}
19

20
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'qn_getBlocksInTimestampRange',
7
  {
8
  "startTimestamp": 1730000000,
9
  "endTimestamp": 1730000100,
10
  "pageSize": 5
11
},
12
  undefined,
13
  'https://docs-demo.base-mainnet.quiknode.pro/'
14
)
15

16
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'qn_getBlocksInTimestampRange',
7
  {
8
  "startTimestamp": 1730000000,
9
  "endTimestamp": 1730000100,
10
  "pageSize": 5
11
},
12
  undefined,
13
  'https://docs-demo.base-mainnet.quiknode.pro/'
14
)
15

16
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "qn_getBlocksInTimestampRange",
8
        {
9
            "startTimestamp": 1730000000,
10
            "endTimestamp": 1730000100,
11
            "pageSize": 5
12
        },
13
        endpoint_url="https://docs-demo.base-mainnet.quiknode.pro/",
14
    )
15
    print(result)
16

17
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "qn_getBlocksInTimestampRange",
8
        {
9
            "startTimestamp": 1730000000,
10
            "endTimestamp": 1730000100,
11
            "pageSize": 5
12
        },
13
        endpoint_url="https://docs-demo.base-mainnet.quiknode.pro/",
14
    )
15
    print(result)
16

17
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "qn_getBlocksInTimestampRange",
7
  params: {
8
    "startTimestamp" => 1730000000,
9
    "endTimestamp" => 1730000100,
10
    "pageSize" => 5
11
  },
12
  endpoint_url: "https://docs-demo.base-mainnet.quiknode.pro/"
13
)
14

15
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "qn_getBlocksInTimestampRange",
7
  params: {
8
    "startTimestamp" => 1730000000,
9
    "endTimestamp" => 1730000100,
10
    "pageSize" => 5
11
  },
12
  endpoint_url: "https://docs-demo.base-mainnet.quiknode.pro/"
13
)
14

15
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "qn_getBlocksInTimestampRange",
10
            Some(serde_json::json!({
11
    "startTimestamp": 1730000000,
12
    "endTimestamp": 1730000100,
13
    "pageSize": 5
14
})),
15
            None,
16
            Some("https://docs-demo.base-mainnet.quiknode.pro/".into()),
17
        )
18
        .await?;
19

20
    println!("{result}");
21
    Ok(())
22
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "qn_getBlocksInTimestampRange",
10
            Some(serde_json::json!({
11
    "startTimestamp": 1730000000,
12
    "endTimestamp": 1730000100,
13
    "pageSize": 5
14
})),
15
            None,
16
            Some("https://docs-demo.base-mainnet.quiknode.pro/".into()),
17
        )
18
        .await?;
19

20
    println!("{result}");
21
    Ok(())
22
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getBlocksInTimestampRange',
4
    params: {"startTimestamp":1730000000,"endTimestamp":1730000100,"pageSize":5},
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.base-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getBlocksInTimestampRange',
4
    params: {"startTimestamp":1730000000,"endTimestamp":1730000100,"pageSize":5},
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.base-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.base-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "qn_getBlocksInTimestampRange",
9
  "params": {
10
    "startTimestamp": 1730000000,
11
    "endTimestamp": 1730000100,
12
    "pageSize": 5
13
  },
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

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

22
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.base-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "qn_getBlocksInTimestampRange",
9
  "params": {
10
    "startTimestamp": 1730000000,
11
    "endTimestamp": 1730000100,
12
    "pageSize": 5
13
  },
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

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

22
print(response.text)

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

5
uri = URI("https://docs-demo.base-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "qn_getBlocksInTimestampRange",
11
  params: {"startTimestamp":1730000000,"endTimestamp":1730000100,"pageSize":5}
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

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

5
uri = URI("https://docs-demo.base-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "qn_getBlocksInTimestampRange",
11
  params: {"startTimestamp":1730000000,"endTimestamp":1730000100,"pageSize":5}
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "blocks": [
6
      {
7
        "blockNumber": 29402654,
8
        "network": "ethereum",
9
        "timestamp": 1730000000
10
      },
11
      {
12
        "blockNumber": 29402655,
13
        "network": "ethereum",
14
        "timestamp": 1730000012
15
      },
16
      {
17
        "blockNumber": 29402656,
18
        "network": "ethereum",
19
        "timestamp": 1730000024
20
      },
21
      {
22
        "blockNumber": 29402657,
23
        "network": "ethereum",
24
        "timestamp": 1730000036
25
      },
26
      {
27
        "blockNumber": 29402658,
28
        "network": "ethereum",
29
        "timestamp": 1730000048
30
      }
31
    ],
32
    "pagination": {
33
      "hasNextPage": true,
34
      "nextPageParams": {
35
        "lastBlockNumber": 29402658,
36
        "lastTimestamp": 1730000048,
37
        "pageSize": 5
38
      }
39
    }
40
  }
41
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "blocks": [
6
      {
7
        "blockNumber": 29402654,
8
        "network": "ethereum",
9
        "timestamp": 1730000000
10
      },
11
      {
12
        "blockNumber": 29402655,
13
        "network": "ethereum",
14
        "timestamp": 1730000012
15
      },
16
      {
17
        "blockNumber": 29402656,
18
        "network": "ethereum",
19
        "timestamp": 1730000024
20
      },
21
      {
22
        "blockNumber": 29402657,
23
        "network": "ethereum",
24
        "timestamp": 1730000036
25
      },
26
      {
27
        "blockNumber": 29402658,
28
        "network": "ethereum",
29
        "timestamp": 1730000048
30
      }
31
    ],
32
    "pagination": {
33
      "hasNextPage": true,
34
      "nextPageParams": {
35
        "lastBlockNumber": 29402658,
36
        "lastTimestamp": 1730000048,
37
        "pageSize": 5
38
      }
39
    }
40
  }
41
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free