eth_getFinalizedHeader RPC Method

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

int

REQUIRED

Loading...

Returns

baseFeePerGas

string

Loading...

blobGasUsed

string

Loading...

difficulty

string

Loading...

excessBlobGas

string

Loading...

extraData

string

Loading...

gasLimit

string

Loading...

gasUsed

string

Loading...

hash

string

Loading...

logsBloom

string

Loading...

milliTimestamp

string

Loading...

miner

string

Loading...

mixHash

string

Loading...

nonce

string

Loading...

number

string

Loading...

parentBeaconBlockRoot

string

Loading...

parentHash

string

Loading...

receiptsRoot

string

Loading...

requestsHash

string

Loading...

sha3Uncles

string

Loading...

size

string

Loading...

stateRoot

string

Loading...

timestamp

string

Loading...

totalDifficulty

string

Loading...

transactionsRoot

string

Loading...

withdrawalsRoot

string

Loading...

Request

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

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

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.bsc.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getFinalizedHeader",
7
    "params": [-3],
8
    "id": 1
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
require 'eth'
2

3
client = Eth::Client.create 'https://docs-demo.bsc.quiknode.pro/'
4
payload = {
5
    "jsonrpc": "2.0",
6
    "method": "eth_getFinalizedHeader",
7
    "params": [-3],
8
    "id": 1
9
}
10

11
response = client.send(payload.to_json)
12
puts response

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.bsc.quiknode.pro/");
4
  const response = await provider.send("eth_getFinalizedHeader", [-3]);
5
  console.log(response);
6
})();

1
import { ethers } from "ethers";
2
(async () => {
3
  const provider = new ethers.JsonRpcProvider("https://docs-demo.bsc.quiknode.pro/");
4
  const response = await provider.send("eth_getFinalizedHeader", [-3]);
5
  console.log(response);
6
})();

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_getFinalizedHeader",
6
  "params": [
7
    -3
8
  ],
9
  "id": 1,
10
  "jsonrpc": "2.0"
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

20
fetch("https://docs-demo.bsc.quiknode.pro/", requestOptions)
21
  .then(response => response.text())
22
  .then(result => console.log(result))
23
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "eth_getFinalizedHeader",
6
  "params": [
7
    -3
8
  ],
9
  "id": 1,
10
  "jsonrpc": "2.0"
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

20
fetch("https://docs-demo.bsc.quiknode.pro/", requestOptions)
21
  .then(response => response.text())
22
  .then(result => console.log(result))
23
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "eth_getFinalizedHeader",
8
  "params": [
9
    -3
10
  ],
11
  "id": 1,
12
  "jsonrpc": "2.0"
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
  "method": "eth_getFinalizedHeader",
8
  "params": [
9
    -3
10
  ],
11
  "id": 1,
12
  "jsonrpc": "2.0"
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
url = URI("https://docs-demo.bsc.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_getFinalizedHeader",
14
  "params": [
15
    -3
16
  ],
17
  "id": 1,
18
  "jsonrpc": "2.0"
19
})
20

21
response = https.request(request)
22
puts response.read_body

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

5
url = URI("https://docs-demo.bsc.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "eth_getFinalizedHeader",
14
  "params": [
15
    -3
16
  ],
17
  "id": 1,
18
  "jsonrpc": "2.0"
19
})
20

21
response = https.request(request)
22
puts response.read_body

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

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free