getblocktemplate | Alchemy Docs

1 import requests 2 3 url = "https://bitcoin-mainnet.g.alchemy.com/v2/:apiKey" 4 5 payload = [ 6 { 7 "mode": "template", 8 "capabilities": ["coinbasetxn", "workid", "coinbase/append"], 9 "rules": ["segwit"] 10 } 11 ] 12 headers = {"Content-Type": "application/json"} 13 14 response = requests.post(url, json=payload, headers=headers) 15 16 print(response.json())

1 { 2 "jsonrpc": "2.0", 3 "id": "1", 4 "result": { 5 "version": 536870912, 6 "previousblockhash": "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80", 7 "transactions": [], 8 "coinbaseaux": { 9 "flags": "" 10 }, 11 "coinbasevalue": 625000000, 12 "target": "0000000000000000000248b60000000000000000000000000000000000000000", 13 "mintime": 1745928076, 14 "mutable": [ 15 "time", 16 "transactions", 17 "prevblock" 18 ], 19 "noncerange": "00000000ffffffff", 20 "sigoplimit": 80000, 21 "sizelimit": 4000000, 22 "curtime": 1745931642, 23 "bits": "170248b6", 24 "height": 894471 25 } 26 }

Returns data needed to construct a block to mine. This method is used by miners to request a block template for mining new blocks. It can be customized with various parameters to specify the desired mining capabilities and rules.

Path Parameters

apiKeystringRequiredDefaults to docs-demo

Request

This endpoint expects an object.

template_requestobjectOptional

A JSON object containing the template request parameters.

Response

A block template object containing all necessary data for mining.

versioninteger or null

The block version.

previousblockhashstring or nullformat: "^[a-fA-F0-9]{64}$"

A 64-character hex string representing the block hash.

transactionslist of objects or null

Contents of non-coinbase transactions that should be included in the next block.

coinbaseauxobject or null

Data that should be included in the coinbase's scriptSig content.

coinbasevalueinteger or null

Maximum allowable input to coinbase transaction, including the mining reward and transaction fees (in satoshis).

targetstring or null

The hash target for the block.

mintimeinteger or null

The minimum timestamp appropriate for the next block time in seconds since epoch.

mutablelist of strings or null

List of ways the block template may be changed.

noncerangestring or null

Range of valid nonces.

sigoplimitinteger or null

Limit of signature operations in blocks.

sizelimitinteger or null

Limit of block size.

curtimeinteger or null

Current timestamp in seconds since epoch.

bitsstring or null

Compressed target of the next block.

heightinteger or null

The height of the next block.