submitheader

POST

/{apiKey}

Decodes the given hex-encoded block header and submits it as a candidate chain tip if valid. Throws an error if the header is invalid. This can be used to mine on top of a particular block without having the full block data.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

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

The hex-encoded block header to submit.

Responses

200

Returns null if the header was accepted, or a string describing the rejection reason.

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": "submitheader",  "params": [    "0000002073bd2184edd74c5c5b4c0c5be04d0e8f5d6b7d5b3b1b1d8e8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c"  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": null}

Was this page helpful?