Please note that this RPC method requires the Single Flight RPC add-on enabled on your Quicknode endpoint.

Parameters

block number

string

REQUIRED

The block number in hexadecimal format

Returns

block

object

The information about the specified block:

baseFeePerGas

string

A string of the base fee encoded as hexadecimal

difficulty

string

The integer of the difficulty for this block encoded as hexadecimal

extraData

string

The extra data field of this block

gasLimit

string

The maximum gas allowed in this block encoded as hexadecimal

gasUsed

string

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

hash

string

The block hash of the requested block. Null when it's pending block

logsBloom

array

The bloom filter for the logs of the block. Null when it's a pending block

miner

string

The address of the beneficiary to whom the mining rewards were given

mixHash

string

A string of a 256-bit hash encoded as hexadecimal

nonce

string

The hash of the generated proof-of-work. Null when it's a pending block

number

string

The block number of the requested block, encoded as hexadecimal. Null when it's a pending block

parentHash

string

The hash of the parent block

receiptsRoot

string

The root of the receipts trie of the block

sha3Uncles

string

The SHA3 of the uncles data in the block

size

string

The size of this block in bytes as an Integer value encoded as hexadecimal

stateRoot

string

The root of the final state trie of the block

timestamp

string

The UNIX timestamp for when the block was collated

totalDifficulty

string

The integer of the total difficulty of the chain until this block encoded as hexadecimal

transactions

array

An array of transaction objects:

blockHash

string

The block hash of the requested block

blockNumber

string

The block number of the requested block, encoded as hexadecimal

from

string

The address of the sender

gas

string

The gas provided by the sender, encoded as hexadecimal

gasPrice

string

The gas price provided by the sender in Wei, encoded as hexadecimal

hash

string

The hash of the transaction

input

string

The data sent along with the transaction

nonce

string

The number of transactions made by the sender prior to this one encoded as hexadecimal

to

string

The address of the receiver. Null when it's a contract creation

transactionIndex

string

The integer of the transactions index position in the block. Null if pending

value

string

The value transferred in Wei, encoded as hexadecimal

type

string

The transaction type

v

string

The ECDSA recovery id encoded as hexadecimal

r

string

The ECDSA signature r

s

string

The ECDSA signature s

maxFeePerGas

string

The maximum fee per gas set in the transaction

maxPriorityFeePerGas

string

The maximum priority gas fee set in the transaction

accessList

array

An array of legacy transaction objects

chainId

string

The chain id of the transaction

transactionsRoot

string

The root of the transaction trie of the block

uncles

string

An array of uncle hashes

withdrawals

array

Withdrawal objects for this block (EIP-4895). Omitted on pre-Shanghai blocks.

index

string

The index of the withdrawal to uniquely identify each withdrawal

validatorIndex

string

The index of the validator who initiated the withdrawal

address

string

The address to which the withdrawn amount is sent

amount

string

The amount of ether, provided in hexadecimal format, corresponding to a certain value in gwei

withdrawalsRoot

string

Merkle root of withdrawal data (EIP-4895). Omitted on pre-Shanghai blocks.

receipts

array

An array of transaction receipt objects for the specified block

blockHash

string

The hash of the block. Null when it's a pending

blockNumber

string

The block number

contractAddress

string

The contract address created if the transaction was a contract creation, otherwise null

cumulativeGasUsed

string

The total amount of gas used when this transaction was executed in the block

effectiveGasPrice

string

The actual value per gas deducted from the senders account

from

string

The address of the sender

gasUsed

string

The amount of gas used by this specific transaction alone

logs

array

An array of log objects generated by this transaction:

address

string

The address from which this log originated

topics

array

An array of zero to four 32 Bytes data of indexed log arguments. In solidity: The first topic is the hash of the signature of the event (e.g. Deposit(address,bytes32,uint256)), except you declare the event with the anonymous specifier

data

string

It contains one or more 32 Bytes non-indexed arguments of the

blockNumber

string

The block number where this log was in. Null when it's a pending

transactionHash

string

The hash of the transactions this log was created from. Null when it's a pending

transactionIndex

string

The integer of the transaction's index position that the log was created from. Null when it's a pending

blockHash

string

The hash of the block where this log was in. Null when it's a pending

logIndex

string

The integer of the log index position in the block. Null when it's a pending

removed

boolean

True when the log was removed, due to a chain reorganization. False if it's a valid

logsBloom

string

The bloom filter for light clients to quickly retrieve related

status

string

Either 1 (success) or 0 (failure)

to

string

The address of the receiver. Null when it's a contract creation

transactionHash

string

The hash of the transaction

transactionIndex

string

The index of the transaction in the block

type

string

The receipt type

Request

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

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

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.optimism.quiknode.pro/");
5
    const response = await provider.send("qn_getBlockWithReceipts", [
6
    "0x7D8E1"
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.optimism.quiknode.pro/");
5
    const response = await provider.send("qn_getBlockWithReceipts", [
6
    "0x7D8E1"
7
]);
8
    console.log(response);
9
}
10

11
main();

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

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

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

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

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

8
    const result = await client.request({
9
        method: 'qn_getBlockWithReceipts',
10
        params: [
11
          "0x7D8E1"
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_getBlockWithReceipts',
7
  [
8
  "0x7D8E1"
9
],
10
  undefined,
11
  'https://docs-demo.optimism.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_getBlockWithReceipts',
7
  [
8
  "0x7D8E1"
9
],
10
  undefined,
11
  'https://docs-demo.optimism.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_getBlockWithReceipts",
8
        [
9
            "0x7D8E1"
10
        ],
11
        endpoint_url="https://docs-demo.optimism.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_getBlockWithReceipts",
8
        [
9
            "0x7D8E1"
10
        ],
11
        endpoint_url="https://docs-demo.optimism.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_getBlockWithReceipts",
7
  params: [
8
    "0x7D8E1"
9
  ],
10
  endpoint_url: "https://docs-demo.optimism.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_getBlockWithReceipts",
7
  params: [
8
    "0x7D8E1"
9
  ],
10
  endpoint_url: "https://docs-demo.optimism.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_getBlockWithReceipts",
10
            Some(serde_json::json!([
11
    "0x7D8E1"
12
])),
13
            None,
14
            Some("https://docs-demo.optimism.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_getBlockWithReceipts",
10
            Some(serde_json::json!([
11
    "0x7D8E1"
12
])),
13
            None,
14
            Some("https://docs-demo.optimism.quiknode.pro/".into()),
15
        )
16
        .await?;
17

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

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

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

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

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

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "qn_getBlockWithReceipts",
11
  params: ["0x7D8E1"]
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
    "receipts": [
6
      {
7
        "blockHash": "0xa605e50c630264a931437b4745ca7a355bb6c41bb9367cffdac514b34355bf82",
8
        "blockNumber": "0x7d8e1",
9
        "contractAddress": null,
10
        "cumulativeGasUsed": "0x5208",
11
        "effectiveGasPrice": "0xba43b7400",
12
        "from": "0xb9f46102e74a8777c95c220529516bbc9492f1d6",
13
        "gasUsed": "0x5208",
14
        "logs": [],
15
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
16
        "status": "",
17
        "to": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
18
        "transactionHash": "0xb85a2d8c702f6276f4c9200fe2549f48f9dcef74d577ed07945b4985d970e606",
19
        "transactionIndex": "0x0",
20
        "type": "0x0"
21
      }
22
    ],
23
    "block": {
24
      "baseFeePerGas": "",
25
      "difficulty": "0x6f9bca6412a",
26
      "extraData": "0xd783010203844765746887676f312e352e31856c696e7578",
27
      "gasLimit": "0x2fefd8",
28
      "gasUsed": "0x5208",
29
      "hash": "0xa605e50c630264a931437b4745ca7a355bb6c41bb9367cffdac514b34355bf82",
30
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
31
      "miner": "0x738db714c08b8a32a29e0e68af00215079aa9c5c",
32
      "mixHash": "0x8672445c504745ff204229234fd79a5b82b9fe9d9a1a8e0c378e1b06a748d6ac",
33
      "nonce": "0xec0bf40d8fb6f263",
34
      "number": "0x7d8e1",
35
      "parentHash": "0xdc1fd3c34ed0269e701cf362e0df03fb43ecbb81effd77f500bf08414f73ffa9",
36
      "receiptsRoot": "0x7349c0a84760b359f865093252342a8d20b27571847d41666d1c3d4199b700a1",
37
      "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
38
      "size": "0x28e",
39
      "stateRoot": "0xfa7cc735c589271360b80493c45d97c41de054e20b2a8fa5628da64113beb91f",
40
      "timestamp": "0x5640b072",
41
      "totalDifficulty": "",
42
      "transactions": [
43
        {
44
          "blockHash": "0xa605e50c630264a931437b4745ca7a355bb6c41bb9367cffdac514b34355bf82",
45
          "blockNumber": "0x7d8e1",
46
          "from": "0xb9f46102e74a8777c95c220529516bbc9492f1d6",
47
          "gas": "0x5208",
48
          "gasPrice": "0xba43b7400",
49
          "hash": "0xb85a2d8c702f6276f4c9200fe2549f48f9dcef74d577ed07945b4985d970e606",
50
          "input": "0x",
51
          "nonce": "0x0",
52
          "to": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
53
          "transactionIndex": "0x0",
54
          "value": "0x8ac3680c5ce46000",
55
          "type": "0x0",
56
          "v": "0x1c",
57
          "r": "0x99854cf9de1cba233276bd948cfec1ebb8992d2dc42b2f2533f7b876ce4a1c3e",
58
          "s": "0x7545f7742a6176044dc0ea055b359bf03eddf942ed9301cda78c146c0f7dc4b2",
59
          "maxFeePerGas": "",
60
          "maxPriorityFeePerGas": "",
61
          "accessList": null,
62
          "chainId": ""
63
        }
64
      ],
65
      "transactionsRoot": "0x9ef5d88b51c4729bfc9e5dad12d4ef3421f3573ab91f1a6f63a4cd2f6011dcbe",
66
      "uncles": []
67
    }
68
  }
69
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "receipts": [
6
      {
7
        "blockHash": "0xa605e50c630264a931437b4745ca7a355bb6c41bb9367cffdac514b34355bf82",
8
        "blockNumber": "0x7d8e1",
9
        "contractAddress": null,
10
        "cumulativeGasUsed": "0x5208",
11
        "effectiveGasPrice": "0xba43b7400",
12
        "from": "0xb9f46102e74a8777c95c220529516bbc9492f1d6",
13
        "gasUsed": "0x5208",
14
        "logs": [],
15
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
16
        "status": "",
17
        "to": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
18
        "transactionHash": "0xb85a2d8c702f6276f4c9200fe2549f48f9dcef74d577ed07945b4985d970e606",
19
        "transactionIndex": "0x0",
20
        "type": "0x0"
21
      }
22
    ],
23
    "block": {
24
      "baseFeePerGas": "",
25
      "difficulty": "0x6f9bca6412a",
26
      "extraData": "0xd783010203844765746887676f312e352e31856c696e7578",
27
      "gasLimit": "0x2fefd8",
28
      "gasUsed": "0x5208",
29
      "hash": "0xa605e50c630264a931437b4745ca7a355bb6c41bb9367cffdac514b34355bf82",
30
      "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
31
      "miner": "0x738db714c08b8a32a29e0e68af00215079aa9c5c",
32
      "mixHash": "0x8672445c504745ff204229234fd79a5b82b9fe9d9a1a8e0c378e1b06a748d6ac",
33
      "nonce": "0xec0bf40d8fb6f263",
34
      "number": "0x7d8e1",
35
      "parentHash": "0xdc1fd3c34ed0269e701cf362e0df03fb43ecbb81effd77f500bf08414f73ffa9",
36
      "receiptsRoot": "0x7349c0a84760b359f865093252342a8d20b27571847d41666d1c3d4199b700a1",
37
      "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
38
      "size": "0x28e",
39
      "stateRoot": "0xfa7cc735c589271360b80493c45d97c41de054e20b2a8fa5628da64113beb91f",
40
      "timestamp": "0x5640b072",
41
      "totalDifficulty": "",
42
      "transactions": [
43
        {
44
          "blockHash": "0xa605e50c630264a931437b4745ca7a355bb6c41bb9367cffdac514b34355bf82",
45
          "blockNumber": "0x7d8e1",
46
          "from": "0xb9f46102e74a8777c95c220529516bbc9492f1d6",
47
          "gas": "0x5208",
48
          "gasPrice": "0xba43b7400",
49
          "hash": "0xb85a2d8c702f6276f4c9200fe2549f48f9dcef74d577ed07945b4985d970e606",
50
          "input": "0x",
51
          "nonce": "0x0",
52
          "to": "0x32be343b94f860124dc4fee278fdcbd38c102d88",
53
          "transactionIndex": "0x0",
54
          "value": "0x8ac3680c5ce46000",
55
          "type": "0x0",
56
          "v": "0x1c",
57
          "r": "0x99854cf9de1cba233276bd948cfec1ebb8992d2dc42b2f2533f7b876ce4a1c3e",
58
          "s": "0x7545f7742a6176044dc0ea055b359bf03eddf942ed9301cda78c146c0f7dc4b2",
59
          "maxFeePerGas": "",
60
          "maxPriorityFeePerGas": "",
61
          "accessList": null,
62
          "chainId": ""
63
        }
64
      ],
65
      "transactionsRoot": "0x9ef5d88b51c4729bfc9e5dad12d4ef3421f3573ab91f1a6f63a4cd2f6011dcbe",
66
      "uncles": []
67
    }
68
  }
69
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free