getblocktemplate

POST

/{apiKey}

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

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

objectoptional

A JSON object containing the template request parameters.

Responses

200

A block template object containing all necessary data for mining.

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": "getblocktemplate",  "params": [    {      "mode": "template",      "capabilities": [        "coinbasetxn",        "workid",        "coinbase/append"      ],      "rules": [        "segwit"      ]    }  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "version": 536870912,    "previousblockhash": "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80",    "transactions": [],    "coinbaseaux": {      "flags": ""    },    "coinbasevalue": 625000000,    "target": "0000000000000000000248b60000000000000000000000000000000000000000",    "mintime": 1745928076,    "mutable": [      "time",      "transactions",      "prevblock"    ],    "noncerange": "00000000ffffffff",    "sigoplimit": 80000,    "sizelimit": 4000000,    "curtime": 1745931642,    "bits": "170248b6",    "height": 894471  }}

Was this page helpful?