submitheader | Alchemy Docs

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

apiKeystringRequiredDefaults to docs-demo

Request

This endpoint expects an object.

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

The hex-encoded block header to submit.

Response

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

1	import requests
2
3	url = "https://bitcoin-mainnet.g.alchemy.com/v2/:apiKey"
4
5	payload = ["0000002073bd2184edd74c5c5b4c0c5be04d0e8f5d6b7d5b3b1b1d8e8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c8b8c"]
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())