Parameters

blockNumber/tag

string

REQUIRED

The block number in hexadecimal format or the string latest or earliest

Returns

object

object | null

A block object, or null when no block was found:

blockScore

string

(Optional) The score of the block, represented in hexadecimal format

extraData

string

The “extra data” field of this block

gasUsed

string

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

governanceData

string

Data related to governance, represented as a hexadecimal string

hash

string | null

The block hash of the requested block. null if pending

logsBloom

string | null

The bloom filter for the logs of the block. null if pending

number

string | null

The block number of the requested block encoded as a hexadecimal. null if pending

parentHash

string

The hash of the parent block

receiptsRoot

string

The root of the receipts trie of the block

reward

string

The address of the account that received the block reward

size

string

(Optional) 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

timestampFoS

string

An additional timestamp field, represented in hexadecimal format

totalBlockScore

string

(Optional) The total score of the blockchain up to and including this block, represented in hexadecimal format

transactions

array

(Optional) An array of transaction objects

transactionsRoot

string

The root of the transaction trie of the block

voteData

string

The data related to votes, represented as a hexadecimal string

Request

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

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

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

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

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

20
fetch("https://docs-demo.kaia-kairos.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": "kaia_getHeaderByNumber",
6
  "id": 1,
7
  "jsonrpc": "2.0",
8
  "params": [
9
    "0x1b4"
10
  ]
11
});
12

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

20
fetch("https://docs-demo.kaia-kairos.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.kaia-kairos.quiknode.pro/"
5

6
payload = json.dumps({
7
  "method": "kaia_getHeaderByNumber",
8
  "id": 1,
9
  "jsonrpc": "2.0",
10
  "params": [
11
    "0x1b4"
12
  ]
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)
21

1
import requests
2
import json
3

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

6
payload = json.dumps({
7
  "method": "kaia_getHeaderByNumber",
8
  "id": 1,
9
  "jsonrpc": "2.0",
10
  "params": [
11
    "0x1b4"
12
  ]
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)
21

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

5
url = URI("https://docs-demo.kaia-kairos.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": "kaia_getHeaderByNumber",
14
  "id": 1,
15
  "jsonrpc": "2.0",
16
  "params": [
17
    "0x1b4"
18
  ]
19
})
20

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

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

5
url = URI("https://docs-demo.kaia-kairos.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": "kaia_getHeaderByNumber",
14
  "id": 1,
15
  "jsonrpc": "2.0",
16
  "params": [
17
    "0x1b4"
18
  ]
19
})
20

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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free