getblockchaininfo | Alchemy Docs

1 curl -X POST https://bitcoin-mainnet.alchemy-blast.com/v2/{apiKey} \ 2 -H "Content-Type: application/json" \ 3 -d '{ 4 "jsonrpc": "2.0", 5 "method": "getblockchaininfo", 6 "params": [], 7 "id": 1 8 }'

1 { 2 "jsonrpc": "2.0", 3 "id": "1", 4 "result": { 5 "chain": "main", 6 "blocks": 894713, 7 "headers": 894713, 8 "bestblockhash": "00000000000000000000eb0ae1714d3ec43cfaac74769f3bcde489daf116e4ca", 9 "bits": "170248b6", 10 "target": "0000000000000000000248b60000000000000000000000000000000000000000", 11 "difficulty": 123234387977050.9, 12 "time": 1746083867, 13 "mediantime": 1746081100, 14 "verificationprogress": 0.9999993374725104, 15 "initialblockdownload": false, 16 "chainwork": "0000000000000000000000000000000000000000bfce6962cc3162143b67a1d4", 17 "size_on_disk": 745999541195, 18 "pruned": false, 19 "warnings": [] 20 } 21 }

Returns an object containing state details related to blockchain processing, network, and storage information.

Path parameters

apiKeystringRequired

Response

Blockchain status information.

chainstring

Current network name (main, test, regtest).

blocksinteger

The current number of blocks.

headersinteger

The current number of headers.

bestblockhashstring

The hash of the best block.

difficultydouble

The current difficulty.

timeinteger

Timestamp of the best block.

mediantimeinteger

Median time of the blockchain.

verificationprogressdouble

Estimate of verification progress (0.0–1.0).

initialblockdownloadboolean

Whether the node is in IBD (initial block download).

chainworkstring

Expected number of hashes required to produce the chain.

size_on_diskinteger

Estimated size of the blockchain stored on disk in bytes.

prunedboolean

If the blockchain is pruned.

bitsstringOptional

The nBits field of the best block header.

targetstringOptional

The target corresponding to current difficulty.

warningslist of stringsOptional

Any network or blockchain warnings.