If the latest block has not yet accumulated the input number (verifiedValidatorNum) of validator votes, the method will return an “unknown block” error with code -39001.

Parameters

verifiedValidatorNum

integer

REQUIRED

Number of validators required to verify the block for probabilistic finality. Must be in [1, len(currentValidators)] or one of the shortcut values: -1 (>= 1/2) validators, -2 (>= 2/3) validators, -3 (all) validators.

Returns

baseFeePerGas

string

Base fee per gas in hex.

blobGasUsed

string

Blob gas used in the block (hex).

difficulty

string

Block difficulty (hex).

excessBlobGas

string

Excess blob gas (hex).

extraData

string

Extra data field (hex).

gasLimit

string

Block gas limit (hex).

gasUsed

string

Total gas used in the block (hex).

hash

string

Block hash (32-byte hex).

logsBloom

string

Bloom filter for logs (hex).

milliTimestamp

string

Block timestamp in milliseconds since Unix epoch (hex).

miner

string

Beneficiary/miner address (hex).

mixHash

string

Mix hash (hex).

nonce

string

Block nonce (hex).

number

string

Block number (hex).

parentBeaconBlockRoot

string

Parent beacon block root (hex).

parentHash

string

Parent block hash (32-byte hex).

receiptsRoot

string

Receipts trie root (32-byte hex).

requestsHash

string

Requests hash (32-byte hex).

sha3Uncles

string

Uncles/ommers hash (32-byte hex).

size

string

Block size in bytes (hex).

stateRoot

string

State trie root (32-byte hex).

timestamp

string

Block timestamp in seconds since Unix epoch (hex).

totalDifficulty

string

Total difficulty up to this block (hex).

transactionsRoot

string

Transactions trie root (32-byte hex).

withdrawalsRoot

string

Withdrawals trie root (32-byte hex).

Request

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

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

1
import { ethers } from "ethers";
2

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

11
main();

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

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

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

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

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

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

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'eth_getFinalizedHeader',
4
    params: [16],
5
    id: 1
6
}
7

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

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

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

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

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

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "eth_getFinalizedHeader",
11
  params: [16]
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": "0xaef721d4d8bdda10406451e4a0df3cc24d8dd11cce5de508a2332281b8e8499e",
6
    "parentHash": "0xbb722a1898c552d8b210e40a937c2f11a3fef3ca7b388330003e1edc3bcd3d1a",
7
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
8
    "miner": "0xccb42a9b8d6c46468900527bc741938e78ab4577",
9
    "stateRoot": "0x9774032a121c4be59cf11df24af756029983932a56b018fd8f10a90694cb2590",
10
    "transactionsRoot": "0xb0997e2f55c3acc986b232c40ba88e01f32722f6f14c679e2fde09b6fed87ed1",
11
    "receiptsRoot": "0xdc9cf5796ad0b1af6341fa4cc1b8db0fe854ba4bf45268f4885618c291433b90",
12
    "logsBloom": "0x3c294ac7600a1818831382c5e15401c81420d3a638810295c31017f809594cd3840ff4f019030585c6df4369db1714c8803cda2b2581b5844d80221010a836942611b3148652452863150e1ad29122ee6c5c5951524a913013240f03a09580bd748c903a92022022a5188a8d85834a655c20de10c2152c0880f74551818f83c0fa50c00e03799d62849ba15bec58cfa2a9f444ed0199ae8c598697d2112406a8c2bd0fd2a86ca1392b5253c3a2565841d11b195249509b405c4c7e00fc208881cca03b1296e0343cc18b201096619c5422c5ce32217036b6997c6312b044ebec4a5e6709100668b765d05bdc10894d606404a0d50f90af7e4e626b2d07a0fec4",
13
    "difficulty": "0x2",
14
    "number": "0x58c79bc",
15
    "gasLimit": "0x3473bc0",
16
    "gasUsed": "0x103f449",
17
    "timestamp": "0x69e25d6a",
18
    "extraData": "0xda8301060588656330623532623388676f312e32342e37836c696e004d518ce1f8b5831fffffb860a5a2264b570b482614ce4af59b044774ea33b34130ee79c7b4b1228e38544e2498a5178d0655da9011644c17ed1f6c410f57b27bd18e76d2b7e5b53cf965bdebd3565c80b3550aeaa51e80634af2ed683a5352ba413ebf8d405a4778574b9e86f84c84058c79baa04bbad07f4d3e57ca80d5ba450aada6cb8047167d99deda2fc7bbed419bc2346584058c79bba0bb722a1898c552d8b210e40a937c2f11a3fef3ca7b388330003e1edc3bcd3d1a80eea8fdf1f4beb56dc8411d9b9ee834d99e21782bf38b49a76f9459e34120c058386dc1b324b0601000d78d572db30fa05e4c16d6d9d1246d328bdc107e8e413900",
19
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000015e",
20
    "nonce": "0x0000000000000000",
21
    "baseFeePerGas": "0x0",
22
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
23
    "blobGasUsed": "0x0",
24
    "excessBlobGas": "0x0",
25
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
26
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
27
    "totalDifficulty": "0xb10082d",
28
    "size": "0x12683",
29
    "milliTimestamp": "0x19d9c3ce76e"
30
  }
31
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "hash": "0xaef721d4d8bdda10406451e4a0df3cc24d8dd11cce5de508a2332281b8e8499e",
6
    "parentHash": "0xbb722a1898c552d8b210e40a937c2f11a3fef3ca7b388330003e1edc3bcd3d1a",
7
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
8
    "miner": "0xccb42a9b8d6c46468900527bc741938e78ab4577",
9
    "stateRoot": "0x9774032a121c4be59cf11df24af756029983932a56b018fd8f10a90694cb2590",
10
    "transactionsRoot": "0xb0997e2f55c3acc986b232c40ba88e01f32722f6f14c679e2fde09b6fed87ed1",
11
    "receiptsRoot": "0xdc9cf5796ad0b1af6341fa4cc1b8db0fe854ba4bf45268f4885618c291433b90",
12
    "logsBloom": "0x3c294ac7600a1818831382c5e15401c81420d3a638810295c31017f809594cd3840ff4f019030585c6df4369db1714c8803cda2b2581b5844d80221010a836942611b3148652452863150e1ad29122ee6c5c5951524a913013240f03a09580bd748c903a92022022a5188a8d85834a655c20de10c2152c0880f74551818f83c0fa50c00e03799d62849ba15bec58cfa2a9f444ed0199ae8c598697d2112406a8c2bd0fd2a86ca1392b5253c3a2565841d11b195249509b405c4c7e00fc208881cca03b1296e0343cc18b201096619c5422c5ce32217036b6997c6312b044ebec4a5e6709100668b765d05bdc10894d606404a0d50f90af7e4e626b2d07a0fec4",
13
    "difficulty": "0x2",
14
    "number": "0x58c79bc",
15
    "gasLimit": "0x3473bc0",
16
    "gasUsed": "0x103f449",
17
    "timestamp": "0x69e25d6a",
18
    "extraData": "0xda8301060588656330623532623388676f312e32342e37836c696e004d518ce1f8b5831fffffb860a5a2264b570b482614ce4af59b044774ea33b34130ee79c7b4b1228e38544e2498a5178d0655da9011644c17ed1f6c410f57b27bd18e76d2b7e5b53cf965bdebd3565c80b3550aeaa51e80634af2ed683a5352ba413ebf8d405a4778574b9e86f84c84058c79baa04bbad07f4d3e57ca80d5ba450aada6cb8047167d99deda2fc7bbed419bc2346584058c79bba0bb722a1898c552d8b210e40a937c2f11a3fef3ca7b388330003e1edc3bcd3d1a80eea8fdf1f4beb56dc8411d9b9ee834d99e21782bf38b49a76f9459e34120c058386dc1b324b0601000d78d572db30fa05e4c16d6d9d1246d328bdc107e8e413900",
19
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000015e",
20
    "nonce": "0x0000000000000000",
21
    "baseFeePerGas": "0x0",
22
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
23
    "blobGasUsed": "0x0",
24
    "excessBlobGas": "0x0",
25
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
26
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
27
    "totalDifficulty": "0xb10082d",
28
    "size": "0x12683",
29
    "milliTimestamp": "0x19d9c3ce76e"
30
  }
31
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free