getblockheader

getblockheader "blockhash" ( verbose )

When verbose is set to false, it returns a serialized, hex-encoded string of data for the block header ‘hash’.

When verbose is set to true, it provides an object containing details about the block header ‘hash’.

Argument #1 – blockhash

Type: string, required

The block hash

Argument #2 – verbose

Type: boolean, optional, default=true

true for a json object, false for the hex-encoded data

Result (for verbose = true)

{                                 (json object)
  "hash" : "hex",                 (string) the block hash (same as provided)
  "confirmations" : n,            (numeric) The number of confirmations, or -1 if the block is not on the main chain
  "height" : n,                   (numeric) The block height or index
  "version" : n,                  (numeric) The block version
  "versionHex" : "hex",           (string) The block version formatted in hexadecimal
  "merkleroot" : "hex",           (string) The merkle root
  "time" : xxx,                   (numeric) The block time expressed in UNIX epoch time
  "mediantime" : xxx,             (numeric) The median block time expressed in UNIX epoch time
  "nonce" : n,                    (numeric) The nonce
  "bits" : "hex",                 (string) The bits
  "difficulty" : n,               (numeric) The difficulty
  "chainwork" : "hex",            (string) Expected number of hashes required to produce the current chain
  "nTx" : n,                      (numeric) The number of transactions in the block
  "previousblockhash" : "hex",    (string) The hash of the previous block
  "nextblockhash" : "hex"         (string) The hash of the next block
}

Result (for verbose=false)

Name	Type	Description
hex	string	A string that is serialized, hex-encoded data for block ‘hash’

Examples

bitcoinevo-cli getblockheader "0000000006967155a1b6404653c7e9c9084979bf939cd70c203fca8a72f84e8c"

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockheader", "params": ["0000000006967155a1b6404653c7e9c9084979bf939cd70c203fca8a72f84e8c"]}' -H 'content-type: text/plain;' http://127.0.0.1:7332/