Parameters

blockNumber

string

REQUIRED

The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized

transaction detail flag

boolean

REQUIRED

(default: false) The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions

Returns

object

object | null

The block object containing metadata, state roots, and transaction references. Null if the block is not found or still pending

baseFeePerGas

string

The base fee per gas for this block encoded as a hexadecimal string

blobGasUsed

string

The total blob gas used by all transactions in this block encoded as a hexadecimal string

difficulty

string

The block difficulty as a hexadecimal string (0x0 on Proof-of-Authority networks)

excessBlobGas

string

The excess blob gas for this block encoded as a hexadecimal string

extraData

string

Arbitrary extra data set by the block proposer encoded as a hex string

gasLimit

string

The maximum gas allowed in this block encoded as a hexadecimal string

gasUsed

string

The total gas used by all transactions in this block encoded as a hexadecimal string

hash

string | null

The hash of the block, null if the block is pending

logsBloom

string | null

The bloom filter for logs generated in this block, null if pending

mainBlockGeneralGasLimit

string

The general gas limit for the main block encoded as a hexadecimal string

miner

string

The address of the block proposer or beneficiary

mixHash

string

Legacy 256-bit hash used for PoW; typically 0x…00 on PoA networks

nonce

string

Legacy PoW nonce; typically 0x0000000000000000 on PoA networks

number

string | null

The block number encoded as a hexadecimal string, null if pending

parentBeaconBlockRoot

string

The root hash of the parent beacon block

parentHash

string

The hash of the parent block

receiptsRoot

string

The root hash of the receipts trie of this block

requestsHash

string

The hash of the requests list associated with this block

sha3Uncles

string

The Keccak-256 hash of the uncles list in this block

sharedGasLimit

string

The gas limit shared between main and side blocks encoded as a hexadecimal string

size

string

The block size in bytes encoded as a hexadecimal string

stateRoot

string

The root hash of the final state trie after processing this block

timestamp

string

The Unix timestamp when the block was produced encoded as a hexadecimal string

timestampMillis

string

The block timestamp in milliseconds encoded as a hexadecimal string

timestampMillisPart

string

Additional millisecond precision component of the block timestamp encoded as a hexadecimal string

transactions

array

Array of transaction hashes (32-byte hex strings) included in this block

transactionsRoot

string

The root hash of the transaction trie of this block

uncles

array

Array of uncle block hashes referenced by this block (often empty on PoA networks)

withdrawals

array

Array of withdrawal entries included in this block or empty if there are none

withdrawalsRoot

string

The root hash of the withdrawals trie of this block

Request

1
curl -X POST "https://docs-demo.tempo-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBlockByNumber",
6
  "params": [
7
    "0x2ac5b2",
8
    false
9
  ],
10
  "id": 1
11
}'

1
curl -X POST "https://docs-demo.tempo-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBlockByNumber",
6
  "params": [
7
    "0x2ac5b2",
8
    false
9
  ],
10
  "id": 1
11
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBlockByNumber", [
6
    "0x2ac5b2",
7
    false
8
]);
9
    console.log(response);
10
}
11

12
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.tempo-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBlockByNumber", [
6
    "0x2ac5b2",
7
    false
8
]);
9
    console.log(response);
10
}
11

12
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBlockByNumber", ["0x2ac5b2",False])
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.tempo-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBlockByNumber", ["0x2ac5b2",False])
4
print(response)

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

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

8
    const result = await client.request({
9
        method: 'eth_getBlockByNumber',
10
        params: [
11
          "0x2ac5b2",
12
          false
13
        ]
14
    })
15

16
    console.log(result)
17
}
18

19
main()

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

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

8
    const result = await client.request({
9
        method: 'eth_getBlockByNumber',
10
        params: [
11
          "0x2ac5b2",
12
          false
13
        ]
14
    })
15

16
    console.log(result)
17
}
18

19
main()

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getBlockByNumber',
7
  [
8
  "0x2ac5b2",
9
  false
10
],
11
  undefined,
12
  'https://docs-demo.tempo-mainnet.quiknode.pro/'
13
)
14

15
console.log(result)

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'eth_getBlockByNumber',
7
  [
8
  "0x2ac5b2",
9
  false
10
],
11
  undefined,
12
  'https://docs-demo.tempo-mainnet.quiknode.pro/'
13
)
14

15
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
        "eth_getBlockByNumber",
8
        [
9
            "0x2ac5b2",
10
            False
11
        ],
12
        endpoint_url="https://docs-demo.tempo-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
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
        "eth_getBlockByNumber",
8
        [
9
            "0x2ac5b2",
10
            False
11
        ],
12
        endpoint_url="https://docs-demo.tempo-mainnet.quiknode.pro/",
13
    )
14
    print(result)
15

16
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: "eth_getBlockByNumber",
7
  params: [
8
    "0x2ac5b2",
9
    false
10
  ],
11
  endpoint_url: "https://docs-demo.tempo-mainnet.quiknode.pro/"
12
)
13

14
puts result

1
require "quicknode_sdk"
2

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

5
result = qn.rpc.call(
6
  method: "eth_getBlockByNumber",
7
  params: [
8
    "0x2ac5b2",
9
    false
10
  ],
11
  endpoint_url: "https://docs-demo.tempo-mainnet.quiknode.pro/"
12
)
13

14
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
            "eth_getBlockByNumber",
10
            Some(serde_json::json!([
11
    "0x2ac5b2",
12
    false
13
])),
14
            None,
15
            Some("https://docs-demo.tempo-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

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

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
            "eth_getBlockByNumber",
10
            Some(serde_json::json!([
11
    "0x2ac5b2",
12
    false
13
])),
14
            None,
15
            Some("https://docs-demo.tempo-mainnet.quiknode.pro/".into()),
16
        )
17
        .await?;
18

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getBlockByNumber',
4
    params: ["0x2ac5b2",false],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.tempo-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: 'eth_getBlockByNumber',
4
    params: ["0x2ac5b2",false],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.tempo-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.tempo-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBlockByNumber",
9
  "params": [
10
    "0x2ac5b2",
11
    False
12
  ],
13
  "id": 1
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

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

21
print(response.text)

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBlockByNumber",
9
  "params": [
10
    "0x2ac5b2",
11
    False
12
  ],
13
  "id": 1
14
})
15
headers = {
16
  'Content-Type': 'application/json'
17
}
18

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

21
print(response.text)

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBlockByNumber",
11
  params: ["0x2ac5b2",false]
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.tempo-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBlockByNumber",
11
  params: ["0x2ac5b2",false]
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
    "hash": "0x5157d3f0006a2c4cccc8c2a0a396a37d74d2469f0ac99d04b7d68c9b694ab906",
6
    "mainBlockGeneralGasLimit": "0xd693a40",
7
    "sharedGasLimit": "0x2faf080",
8
    "timestampMillisPart": "0x3d9",
9
    "parentHash": "0x781bbb4516eb0de6542b6d6469a85c91c71e119eacd1c70d67e92d5d31c94aa8",
10
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
11
    "miner": "0x0000000000000000000000000000000000000000",
12
    "stateRoot": "0x93700ba0e441f07bcd3cece097c28e9c798645aa11a54e6805d4ddbc1c8d20ab",
13
    "transactionsRoot": "0x2835455211cef45b0c5ed6522e1f918b3a01f85ea4991c9fb4688b250a68edac",
14
    "receiptsRoot": "0x3576ce50ecfabd9b63de477982856b33dddf2fed25dcf93ca76a53931cf658ae",
15
    "logsBloom": "0x0480000000020000000002080000104000000000002020000020010000220000000008040000000000000154410042000000000000001048000000100020000028008400002000000000000800000400000800000000000000020000848000400881000202080000028442000000080004000000800041016220101000000800c0000000010000000004000800220040180000049001200001604210004000104200a0003002000127000080300400000040006400020000000000000000400840000002000000c001002004800000010000900000800000021002c0308822000010000010000002000100000000000082800830000000200000000004404000",
16
    "difficulty": "0x0",
17
    "number": "0x2ac5b2",
18
    "gasLimit": "0x1dcd6500",
19
    "gasUsed": "0x1e17e1",
20
    "timestamp": "0x69793d4b",
21
    "extraData": "0x",
22
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
23
    "nonce": "0x0000000000000000",
24
    "baseFeePerGas": "0x2540be400",
25
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
26
    "blobGasUsed": "0x0",
27
    "excessBlobGas": "0x0",
28
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
29
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
30
    "size": "0x2845",
31
    "timestampMillis": "0x19c019770d1",
32
    "uncles": [],
33
    "transactions": [
34
      "0x65fd05c6d7ba5f032fe9f99274b6e82920fdc1f5521b95d91067dff1fbc52564",
35
      "0x182b7337bc075228ec7c101efc343a3f9215885ec744db0af385209781b72962",
36
      "0x5c2a03f2fa403e9218811e558105eac37f5383badf0dd16761bfa083ecca4d8d",
37
      "0xc785ff35994539418668ddf86b432773165cc778c726e9c1a975a8d17e6bcc18",
38
      "0x54de4d720dad1ae7c6a618a9b24cfc11a31929fbfe12a40f047b9ca14c14f209",
39
      "0x69cf85d5fe6eeb03f6e1d9c9ee8456392d9644b1f6f30e542264ddd1ff0d115c",
40
      "0xfe1947ecfb582d7abc766a6364676936840502283534b3e3d886b723bb756a35",
41
      "0x610d84e558524bfee9e101c3172725acf8686d411bad48a27632eb720a7c756f",
42
      "0x1ce38a68a1c28ea60815f55f99e52192f78067c184b903647330b83e8bd903f4",
43
      "0xe041da37c23bae5e8ab1e061fd7a5db7a0583cd5fcc60ddf668e4bbf5c785506",
44
      "0xf9f522fba42b2f3c874faf887f2dda95db4b00c45da8ef3afa9a51e4d271bfea",
45
      "0x5f51e708b8a2d216de44a1ffa161a361786e1a5467f4cc5f5887a61ca89875ef",
46
      "0xd4951dc017b9fb5eafb9c9dc05c8a3cd3fce7b47801bd0311c5ee95a91617fe8",
47
      "0x67d7d3656467be3d1faa86c2d2ad8d184688c75099b9389b3fcfa7f909136ada",
48
      "0xb1b0be6fe2a4de75a4d9f38ac465ed472e6719e7bff9cdb2a427b940e84b9223",
49
      "0xf2a566ea200de3ffd6e16cb75ae801847d1605081b656e282f147e9b74b8e35a",
50
      "0xaffecdc938ce666a9ba3fd9aa72d609dc82dd28bf241af725134c71fbab6c84e",
51
      "0xb29c0e11efe5d2602363ca60aec9f53380baa0cb6f0edd656028a44d98773427",
52
      "0x47b554ea602db9f5addfa1656b9531b88051bbe832e295f92cae486500beaf4c"
53
    ],
54
    "withdrawals": []
55
  }
56
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "hash": "0x5157d3f0006a2c4cccc8c2a0a396a37d74d2469f0ac99d04b7d68c9b694ab906",
6
    "mainBlockGeneralGasLimit": "0xd693a40",
7
    "sharedGasLimit": "0x2faf080",
8
    "timestampMillisPart": "0x3d9",
9
    "parentHash": "0x781bbb4516eb0de6542b6d6469a85c91c71e119eacd1c70d67e92d5d31c94aa8",
10
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
11
    "miner": "0x0000000000000000000000000000000000000000",
12
    "stateRoot": "0x93700ba0e441f07bcd3cece097c28e9c798645aa11a54e6805d4ddbc1c8d20ab",
13
    "transactionsRoot": "0x2835455211cef45b0c5ed6522e1f918b3a01f85ea4991c9fb4688b250a68edac",
14
    "receiptsRoot": "0x3576ce50ecfabd9b63de477982856b33dddf2fed25dcf93ca76a53931cf658ae",
15
    "logsBloom": "0x0480000000020000000002080000104000000000002020000020010000220000000008040000000000000154410042000000000000001048000000100020000028008400002000000000000800000400000800000000000000020000848000400881000202080000028442000000080004000000800041016220101000000800c0000000010000000004000800220040180000049001200001604210004000104200a0003002000127000080300400000040006400020000000000000000400840000002000000c001002004800000010000900000800000021002c0308822000010000010000002000100000000000082800830000000200000000004404000",
16
    "difficulty": "0x0",
17
    "number": "0x2ac5b2",
18
    "gasLimit": "0x1dcd6500",
19
    "gasUsed": "0x1e17e1",
20
    "timestamp": "0x69793d4b",
21
    "extraData": "0x",
22
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
23
    "nonce": "0x0000000000000000",
24
    "baseFeePerGas": "0x2540be400",
25
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
26
    "blobGasUsed": "0x0",
27
    "excessBlobGas": "0x0",
28
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
29
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
30
    "size": "0x2845",
31
    "timestampMillis": "0x19c019770d1",
32
    "uncles": [],
33
    "transactions": [
34
      "0x65fd05c6d7ba5f032fe9f99274b6e82920fdc1f5521b95d91067dff1fbc52564",
35
      "0x182b7337bc075228ec7c101efc343a3f9215885ec744db0af385209781b72962",
36
      "0x5c2a03f2fa403e9218811e558105eac37f5383badf0dd16761bfa083ecca4d8d",
37
      "0xc785ff35994539418668ddf86b432773165cc778c726e9c1a975a8d17e6bcc18",
38
      "0x54de4d720dad1ae7c6a618a9b24cfc11a31929fbfe12a40f047b9ca14c14f209",
39
      "0x69cf85d5fe6eeb03f6e1d9c9ee8456392d9644b1f6f30e542264ddd1ff0d115c",
40
      "0xfe1947ecfb582d7abc766a6364676936840502283534b3e3d886b723bb756a35",
41
      "0x610d84e558524bfee9e101c3172725acf8686d411bad48a27632eb720a7c756f",
42
      "0x1ce38a68a1c28ea60815f55f99e52192f78067c184b903647330b83e8bd903f4",
43
      "0xe041da37c23bae5e8ab1e061fd7a5db7a0583cd5fcc60ddf668e4bbf5c785506",
44
      "0xf9f522fba42b2f3c874faf887f2dda95db4b00c45da8ef3afa9a51e4d271bfea",
45
      "0x5f51e708b8a2d216de44a1ffa161a361786e1a5467f4cc5f5887a61ca89875ef",
46
      "0xd4951dc017b9fb5eafb9c9dc05c8a3cd3fce7b47801bd0311c5ee95a91617fe8",
47
      "0x67d7d3656467be3d1faa86c2d2ad8d184688c75099b9389b3fcfa7f909136ada",
48
      "0xb1b0be6fe2a4de75a4d9f38ac465ed472e6719e7bff9cdb2a427b940e84b9223",
49
      "0xf2a566ea200de3ffd6e16cb75ae801847d1605081b656e282f147e9b74b8e35a",
50
      "0xaffecdc938ce666a9ba3fd9aa72d609dc82dd28bf241af725134c71fbab6c84e",
51
      "0xb29c0e11efe5d2602363ca60aec9f53380baa0cb6f0edd656028a44d98773427",
52
      "0x47b554ea602db9f5addfa1656b9531b88051bbe832e295f92cae486500beaf4c"
53
    ],
54
    "withdrawals": []
55
  }
56
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free