Parameters

blockhash

string

REQUIRED

The hash of the block

verbose

boolean

Default true. When true returns JSON object, when false returns hex-encoded data

Returns

(for verbose = true):

object

Response when verbose is true (the default). The JSON-RPC body includes result (block header object), error, and id.

result

object

The block header object

hash

string

The hash of the block

confirmations

integer

The number of confirmations, or -1 if the block is not on the main chain

height

integer

The block height or index

version

integer

The block version

versionHex

string

The block version formatted in hexadecimal

merkleroot

string

The merkle root

time

integer

The block time expressed in UNIX epoch time

mediantime

integer

The median block time expressed in UNIX epoch time

nonce

integer

The nonce

bits

string

The value of the nBits field in the block header

difficulty

integer

The estimated amount of work done to find this block relative to the estimated amount of work done to find block 0

chainwork

string

Expected number of hashes required to produce the current chain

nTx

integer

The number of transactions in the block

previousblockhash

string

The hash of the previous block (if available)

nextblockhash

string

The hash of the next block (if available)

error

object | null

JSON-RPC error object when the request failed, or null on success

id

integer

The JSON-RPC request identifier

(for verbose = false):

object

Response when verbose is false. The JSON-RPC body includes result (hex-encoded serialized block header), error, and id.

result

string

A hex-encoded string of the serialized block header

error

object | null

JSON-RPC error object when the request failed, or null on success

id

integer

The JSON-RPC request identifier

Request

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

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

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'getblockheader',
4
    params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",true],
5
    id: 1
6
}
7

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

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

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "getblockheader",
9
  "params": [
10
    "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
11
    True
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.bch-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "getblockheader",
9
  "params": [
10
    "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
11
    True
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.bch-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getblockheader",
11
  params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",true]
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.bch-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "getblockheader",
11
  params: ["00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",true]
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
  "result": "010000007de867cc8adc5cc8fb6b898ca4462cf9fd667d7830a275277447e60800000000338f121232e169d3100edd82004dc2a1f0e1f030c6c488fa61eafa930b0528fe021f7449ffff001d36b4af9a",
3
  "error": null,
4
  "id": 1
5
}

1
{
2
  "result": "010000007de867cc8adc5cc8fb6b898ca4462cf9fd667d7830a275277447e60800000000338f121232e169d3100edd82004dc2a1f0e1f030c6c488fa61eafa930b0528fe021f7449ffff001d36b4af9a",
3
  "error": null,
4
  "id": 1
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free