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

timestamp

integer

REQUIRED

A Unix timestamp (in seconds) representing the time at or before which the desired block should be retrieved

Returns

result

object

The result object which contains the following fields:

network

string

The blockchain network on which the block exists

blockNumber

integer

The most recent block on the blockchain that was generated at or before the specified Unix timestamp

timestamp

integer

The actual timestamp of the returned block in seconds

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_getBlockFromTimestamp",
6
  "params": {
7
    "timestamp": 1730000000
8
  },
9
  "id": 1
10
}'

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_getBlockFromTimestamp",
6
  "params": {
7
    "timestamp": 1730000000
8
  },
9
  "id": 1
10
}'

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_getBlockFromTimestamp", {
6
    "timestamp": 1730000000
7
});
8
    console.log(response);
9
}
10

11
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_getBlockFromTimestamp", {
6
    "timestamp": 1730000000
7
});
8
    console.log(response);
9
}
10

11
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_getBlockFromTimestamp", {"timestamp":1730000000})
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_getBlockFromTimestamp", {"timestamp":1730000000})
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_getBlockFromTimestamp',
10
        params: {
11
          "timestamp": 1730000000
12
        }
13
    })
14

15
    console.log(result)
16
}
17

18
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_getBlockFromTimestamp',
10
        params: {
11
          "timestamp": 1730000000
12
        }
13
    })
14

15
    console.log(result)
16
}
17

18
main()

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

3
const qn = new QuicknodeSdk({})
4

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

14
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_getBlockFromTimestamp',
7
  {
8
  "timestamp": 1730000000
9
},
10
  undefined,
11
  'https://docs-demo.base-mainnet.quiknode.pro/'
12
)
13

14
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_getBlockFromTimestamp",
8
        {
9
            "timestamp": 1730000000
10
        },
11
        endpoint_url="https://docs-demo.base-mainnet.quiknode.pro/",
12
    )
13
    print(result)
14

15
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_getBlockFromTimestamp",
8
        {
9
            "timestamp": 1730000000
10
        },
11
        endpoint_url="https://docs-demo.base-mainnet.quiknode.pro/",
12
    )
13
    print(result)
14

15
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_getBlockFromTimestamp",
7
  params: {
8
    "timestamp" => 1730000000
9
  },
10
  endpoint_url: "https://docs-demo.base-mainnet.quiknode.pro/"
11
)
12

13
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_getBlockFromTimestamp",
7
  params: {
8
    "timestamp" => 1730000000
9
  },
10
  endpoint_url: "https://docs-demo.base-mainnet.quiknode.pro/"
11
)
12

13
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_getBlockFromTimestamp",
10
            Some(serde_json::json!({
11
    "timestamp": 1730000000
12
})),
13
            None,
14
            Some("https://docs-demo.base-mainnet.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

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_getBlockFromTimestamp",
10
            Some(serde_json::json!({
11
    "timestamp": 1730000000
12
})),
13
            None,
14
            Some("https://docs-demo.base-mainnet.quiknode.pro/".into()),
15
        )
16
        .await?;
17

18
    println!("{result}");
19
    Ok(())
20
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'qn_getBlockFromTimestamp',
4
    params: {"timestamp":1730000000},
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_getBlockFromTimestamp',
4
    params: {"timestamp":1730000000},
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_getBlockFromTimestamp",
9
  "params": {
10
    "timestamp": 1730000000
11
  },
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

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

20
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_getBlockFromTimestamp",
9
  "params": {
10
    "timestamp": 1730000000
11
  },
12
  "id": 1
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

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

20
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_getBlockFromTimestamp",
11
  params: {"timestamp":1730000000}
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_getBlockFromTimestamp",
11
  params: {"timestamp":1730000000}
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
    "network": "ethereum",
6
    "blockNumber": 29402654,
7
    "timestamp": 1730000000
8
  }
9
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "network": "ethereum",
6
    "blockNumber": 29402654,
7
    "timestamp": 1730000000
8
  }
9
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free