Parameters

blockNumber/tag

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

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 set by the network for this block encoded as a hexadecimal string

blobGasUsed

string

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

difficulty

string

The block difficulty as a hexadecimal string, 0x0 on proof-of-stake networks

excessBlobGas

string

The excess blob gas carried over from the previous block encoded as a hexadecimal string

extraData

string

The extra data field 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

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

logsBloom

string

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

miner

string

The address of the block proposer or beneficiary of block rewards

mixHash

string

The 256-bit hash used for validating proof-of-work, typically zeroed on proof-of-stake networks

nonce

string

The block nonce value used in proof-of-work, zeroed or null on proof-of-stake networks

number

string

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

parentBeaconBlockRoot

string

The root of the corresponding beacon block that this block is built on

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 requests included in this block, used by some L2 or EIP-4844 implementations

sha3Uncles

string

The SHA3 of the uncles list in this block

size

string

The block size in bytes encoded as a hexadecimal string

stateRoot

string

The root hash of the final state trie after all transactions in this block

timestamp

string

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

transactions

array

The array of transaction hashes included in this block

transactionsRoot

string

The root hash of the transaction trie of this block

uncles

array

The array of uncle block hashes referenced by this block

withdrawals

array

The array of withdrawal operations included in this block, applicable to post-Shanghai blocks

index

string

Withdrawal index encoded as a hexadecimal string

validatorIndex

string

Validator index encoded as a hexadecimal string

address

string

Recipient address for the withdrawal

amount

string

Amount withdrawn in gwei encoded as a hexadecimal string

withdrawalsRoot

string

The root hash of the withdrawals trie of this block

Request

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

1
curl -X POST "https://docs-demo.arc-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "eth_getBlockByNumber",
6
  "params": [
7
    "0x246f",
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.arc-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBlockByNumber", [
6
    "0x246f",
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.arc-mainnet.quiknode.pro/");
5
    const response = await provider.send("eth_getBlockByNumber", [
6
    "0x246f",
7
    false
8
]);
9
    console.log(response);
10
}
11

12
main();

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

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.arc-mainnet.quiknode.pro/'))
3
response = w3.provider.make_request("eth_getBlockByNumber", ["0x246f",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.arc-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_getBlockByNumber',
10
        params: [
11
          "0x246f",
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.arc-mainnet.quiknode.pro/')
6
    })
7

8
    const result = await client.request({
9
        method: 'eth_getBlockByNumber',
10
        params: [
11
          "0x246f",
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
  "0x246f",
9
  false
10
],
11
  undefined,
12
  'https://docs-demo.arc-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
  "0x246f",
9
  false
10
],
11
  undefined,
12
  'https://docs-demo.arc-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
            "0x246f",
10
            False
11
        ],
12
        endpoint_url="https://docs-demo.arc-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
            "0x246f",
10
            False
11
        ],
12
        endpoint_url="https://docs-demo.arc-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
    "0x246f",
9
    false
10
  ],
11
  endpoint_url: "https://docs-demo.arc-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
    "0x246f",
9
    false
10
  ],
11
  endpoint_url: "https://docs-demo.arc-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
    "0x246f",
12
    false
13
])),
14
            None,
15
            Some("https://docs-demo.arc-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
    "0x246f",
12
    false
13
])),
14
            None,
15
            Some("https://docs-demo.arc-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: ["0x246f",false],
5
    id: 1
6
}
7

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

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBlockByNumber",
9
  "params": [
10
    "0x246f",
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.arc-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "eth_getBlockByNumber",
9
  "params": [
10
    "0x246f",
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.arc-mainnet.quiknode.pro/")
6

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBlockByNumber",
11
  params: ["0x246f",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": "0x03237b3946839e05dd1acc6fe9ff486ffb89ba89d5955e829cccc431a1a1180f",
6
    "parentHash": "0x26fa77b1149ded6fb0100ca8fcb75ee8e101bb451c9d74fcd5da97ea1c56871c",
7
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
8
    "miner": "0xa693cc18aa09d33dd388013b7a02e5ff863b8760",
9
    "stateRoot": "0x375ea5b3f76ed886883266d957aaf7db2545e4e0bb6e6978890c4b05c687c132",
10
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
11
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
12
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
13
    "difficulty": "0x0",
14
    "number": "0x48b041",
15
    "gasLimit": "0x2255100",
16
    "gasUsed": "0x0",
17
    "timestamp": "0x68e670e1",
18
    "extraData": "0x",
19
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
20
    "nonce": "0x0000000000000000",
21
    "baseFeePerGas": "0x7",
22
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
23
    "blobGasUsed": "0x0",
24
    "excessBlobGas": "0x0",
25
    "parentBeaconBlockRoot": "0x26fa77b1149ded6fb0100ca8fcb75ee8e101bb451c9d74fcd5da97ea1c56871c",
26
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
27
    "size": "0x267",
28
    "uncles": [],
29
    "transactions": [],
30
    "withdrawals": []
31
  }
32
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "hash": "0x03237b3946839e05dd1acc6fe9ff486ffb89ba89d5955e829cccc431a1a1180f",
6
    "parentHash": "0x26fa77b1149ded6fb0100ca8fcb75ee8e101bb451c9d74fcd5da97ea1c56871c",
7
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
8
    "miner": "0xa693cc18aa09d33dd388013b7a02e5ff863b8760",
9
    "stateRoot": "0x375ea5b3f76ed886883266d957aaf7db2545e4e0bb6e6978890c4b05c687c132",
10
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
11
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
12
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
13
    "difficulty": "0x0",
14
    "number": "0x48b041",
15
    "gasLimit": "0x2255100",
16
    "gasUsed": "0x0",
17
    "timestamp": "0x68e670e1",
18
    "extraData": "0x",
19
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
20
    "nonce": "0x0000000000000000",
21
    "baseFeePerGas": "0x7",
22
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
23
    "blobGasUsed": "0x0",
24
    "excessBlobGas": "0x0",
25
    "parentBeaconBlockRoot": "0x26fa77b1149ded6fb0100ca8fcb75ee8e101bb451c9d74fcd5da97ea1c56871c",
26
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
27
    "size": "0x267",
28
    "uncles": [],
29
    "transactions": [],
30
    "withdrawals": []
31
  }
32
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free