getblockheader

POST

/{apiKey}

Returns the block header for the specified block hash.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringformat: "^[a-fA-F0-9]{64}$"required

The block hash to retrieve the header for.

booleanoptionaldefaults to true

Whether to return a JSON object (true) or raw hex-encoded string (false). Default is true.

Responses

200

The block header as an object or hex string depending on verbose.

POST/v2/{apiKey}

curl --request POST \  --url https://bitcoin-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "getblockheader",  "params": [    "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80",    true  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "hash": "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80",    "confirmations": 154,    "height": 894470,    "version": 537067520,    "versionHex": "20030000",    "merkleroot": "9d93ae25de98e5ed33aec9ccfea612c3b5b181a60171ba564ec1634786b04bc6",    "time": 1745931642,    "mediantime": 1745928076,    "nonce": 766301978,    "bits": "170248b6",    "difficulty": 123234387977050.9,    "chainwork": "0000000000000000000000000000000000000000bf64054821a76841a63cb26e",    "nTx": 2186,    "previousblockhash": "00000000000000000001aa9a63c6c0774a767f7a4d37d2bce3658728de76a146",    "nextblockhash": "00000000000000000000cb8a1d7945b960985579525957bcc37b22174f1ecb31"  }}

Was this page helpful?