Parameters

hash

string

REQUIRED

The hash (32 bytes) of the block

transaction detail flag

boolean

REQUIRED

(default: false) It returns the full transaction objects when it 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 for this block encoded as a hexadecimal string

blobGasUsed

string

The total blob gas used by 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 after 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

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 parent beacon block root encoded as a hexadecimal string

parentHash

string

The hash of the parent block

receiptsRoot

string

The root hash of the receipts trie of this block

requestsHash

string

The requests hash for this block encoded as a hexadecimal string

sha3Uncles

string

The Keccak-256 hash 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 processing this block

timestamp

string

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

totalDifficulty

string

(Optional) The total difficulty of the chain up to and including this block encoded as a hexadecimal string (0x0 on PoA networks)

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 objects for this block

withdrawalsRoot

string

The root hash of withdrawals in this block encoded as a hexadecimal string

Request

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

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

12
main();

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.xrplevm-mainnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getBlockByHash",
7
    "params": [
8
        "0x652cc2948e62c88bc8ae0e4bf3a43ac998b6d4187ec7f4ac77f151cd5cd47568",
9
        false
10
    ],
11
    "id": "1"
12
}
13

14
response = client.send(payload.to_json)
15
puts response

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.xrplevm-mainnet.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getBlockByHash",
7
    "params": [
8
        "0x652cc2948e62c88bc8ae0e4bf3a43ac998b6d4187ec7f4ac77f151cd5cd47568",
9
        false
10
    ],
11
    "id": "1"
12
}
13

14
response = client.send(payload.to_json)
15
puts response

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

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

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

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

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

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

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

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

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

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getBlockByHash",
11
  params: ["0x652cc2948e62c88bc8ae0e4bf3a43ac998b6d4187ec7f4ac77f151cd5cd47568",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
    "baseFeePerGas": "0x2e90edd000",
6
    "difficulty": "0x0",
7
    "extraData": "0x",
8
    "gasLimit": "0x1406f40",
9
    "gasUsed": "0x11f6a",
10
    "hash": "0x652cc2948e62c88bc8ae0e4bf3a43ac998b6d4187ec7f4ac77f151cd5cd47568",
11
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
12
    "miner": "0x475818d36d75207b5ff874c8edc5a474d44fe52c",
13
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
14
    "nonce": "0x0000000000000000",
15
    "number": "0x2b4296",
16
    "parentHash": "0x7f57c72a8ef43a4e0d644cf9995086273858bd56c9f744e802dfcecdf383640f",
17
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
18
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
19
    "size": "0xd8f",
20
    "stateRoot": "0x46ca2622ae1b18ccb327fad789b187c96f6d7637095f30d167e0e9367cbf7082",
21
    "timestamp": "0x68ff6077",
22
    "totalDifficulty": "0x0",
23
    "transactions": [
24
      "0x00aa1a7cdb100fdaf8af6c725bf168c0eec7eb98c515f13258c84cba25cc6b92"
25
    ],
26
    "transactionsRoot": "0x29fc797a08392a4f4d5da5438d4ec7f48a8ec52a5eef6e0d504fe9423e8e9132",
27
    "uncles": [],
28
    "blobGasUsed": "0x0",
29
    "excessBlobGas": "0x0",
30
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
31
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
32
    "withdrawals": [],
33
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
34
  }
35
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "baseFeePerGas": "0x2e90edd000",
6
    "difficulty": "0x0",
7
    "extraData": "0x",
8
    "gasLimit": "0x1406f40",
9
    "gasUsed": "0x11f6a",
10
    "hash": "0x652cc2948e62c88bc8ae0e4bf3a43ac998b6d4187ec7f4ac77f151cd5cd47568",
11
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
12
    "miner": "0x475818d36d75207b5ff874c8edc5a474d44fe52c",
13
    "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
14
    "nonce": "0x0000000000000000",
15
    "number": "0x2b4296",
16
    "parentHash": "0x7f57c72a8ef43a4e0d644cf9995086273858bd56c9f744e802dfcecdf383640f",
17
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
18
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
19
    "size": "0xd8f",
20
    "stateRoot": "0x46ca2622ae1b18ccb327fad789b187c96f6d7637095f30d167e0e9367cbf7082",
21
    "timestamp": "0x68ff6077",
22
    "totalDifficulty": "0x0",
23
    "transactions": [
24
      "0x00aa1a7cdb100fdaf8af6c725bf168c0eec7eb98c515f13258c84cba25cc6b92"
25
    ],
26
    "transactionsRoot": "0x29fc797a08392a4f4d5da5438d4ec7f48a8ec52a5eef6e0d504fe9423e8e9132",
27
    "uncles": [],
28
    "blobGasUsed": "0x0",
29
    "excessBlobGas": "0x0",
30
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
31
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
32
    "withdrawals": [],
33
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
34
  }
35
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free