Path Parameters

Query Parameters

finalized

boolean

Boolean representing whether or not to get the finalized head. If it is not set the value defaults to true. When set to false it will attempt to get the newest known block, which may not be finalized.

Returns

number

string

The block number in hexadecimal format

parentHash

string

The hash of the parent block, which links the current block to its predecessor

stateRoot

string

The hash of the state trie root after all extrinsics in the block have been executed

extrinsicRoot

string

(Optional) The Merkle root of all extrinsics included in the block

digest

object

The digest object which contains the following fields:

logs

array

A list of logs that provide consensus-specific information

preRuntime

array

The log entry containing consensus engine-specific data before block execution

seal

array

The log entry containing the block's final seal, used to verify the block's validity.

consensus

array

The consensus engine identifier

Request

1
# AssetHub (default) - for head block header from AssetHub parachain
2
curl --location 'https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=true' \
3
--header 'Accept: application/json'
4

5
# Polkadot Relaychain - for head block header from Relaychain (requires /rc prefix)
6
curl --location 'https://docs-demo.dot-mainnet.quiknode.pro/rc/blocks/head/header?finalized=true' \
7
--header 'Accept: application/json'

1
# AssetHub (default) - for head block header from AssetHub parachain
2
curl --location 'https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=true' \
3
--header 'Accept: application/json'
4

5
# Polkadot Relaychain - for head block header from Relaychain (requires /rc prefix)
6
curl --location 'https://docs-demo.dot-mainnet.quiknode.pro/rc/blocks/head/header?finalized=true' \
7
--header 'Accept: application/json'

1
// For Polkadot Relaychain access, add '/rc' after https://docs-demo.dot-mainnet.quiknode.pro/ (e.g., https://docs-demo.dot-mainnet.quiknode.pro/rc/accounts/...)
2

3
const myHeaders = new Headers();
4
myHeaders.append("Accept", "application/json");
5

6
const requestOptions = {
7
  method: "GET",
8
  headers: myHeaders,
9
  redirect: "follow"
10
};
11

12
  fetch("https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=true", requestOptions)
13
    .then((response) => response.text())
14
    .then((result) => console.log(result))
15
    .catch((error) => console.error(error));
16

1
// For Polkadot Relaychain access, add '/rc' after https://docs-demo.dot-mainnet.quiknode.pro/ (e.g., https://docs-demo.dot-mainnet.quiknode.pro/rc/accounts/...)
2

3
const myHeaders = new Headers();
4
myHeaders.append("Accept", "application/json");
5

6
const requestOptions = {
7
  method: "GET",
8
  headers: myHeaders,
9
  redirect: "follow"
10
};
11

12
  fetch("https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=true", requestOptions)
13
    .then((response) => response.text())
14
    .then((result) => console.log(result))
15
    .catch((error) => console.error(error));
16

1
import requests
2
# For Polkadot Relaychain access, add '/rc' after https://docs-demo.dot-mainnet.quiknode.pro/ (e.g., https://docs-demo.dot-mainnet.quiknode.pro/rc/accounts/...)
3

4

5
url = "https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=True"
6
payload = {}
7
headers = {
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers, data=payload)
12
print(response.text)
13

1
import requests
2
# For Polkadot Relaychain access, add '/rc' after https://docs-demo.dot-mainnet.quiknode.pro/ (e.g., https://docs-demo.dot-mainnet.quiknode.pro/rc/accounts/...)
3

4

5
url = "https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=True"
6
payload = {}
7
headers = {
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers, data=payload)
12
print(response.text)
13

1
require "uri"
2
require "net/http"
3
# For Polkadot Relaychain access, add '/rc' after https://docs-demo.dot-mainnet.quiknode.pro/ (e.g., https://docs-demo.dot-mainnet.quiknode.pro/rc/accounts/...)
4

5

6
url = URI("https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=true")
7

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

11
request = Net::HTTP::Get.new(url)
12

13
response = https.request(request)
14
puts response.read_body
15

1
require "uri"
2
require "net/http"
3
# For Polkadot Relaychain access, add '/rc' after https://docs-demo.dot-mainnet.quiknode.pro/ (e.g., https://docs-demo.dot-mainnet.quiknode.pro/rc/accounts/...)
4

5

6
url = URI("https://docs-demo.dot-mainnet.quiknode.pro/blocks/head/header?finalized=true")
7

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

11
request = Net::HTTP::Get.new(url)
12

13
response = https.request(request)
14
puts response.read_body
15

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free