getbestblockhash

getbestblockhash returns the 64-character hex hash of the block at the very top of the Bitcoin chain — the tip of the most-work fully-validated branch that the node currently follows. Because Bitcoin secures its ledger of BTC value with Proof-of-Work and produces a block roughly every ten minutes, this hash is the single anchor point for "where the chain is right now." Call it against the Bitcoin Core JSON-RPC endpoint at https://bitcoin.therpc.io/YOUR_API_KEY whenever you need a starting reference for a scan, a fresh tip to compare against, or the hash you will feed into getblock or getblockheader.

Use cases

• Grab the current tip hash to anchor a block scan or to notice when a new block has arrived.
• Pair it with getblockcount so you hold both the tip hash and its height for confirmation math.
• Poll the tip hash on a short interval and react to reorgs when the value changes unexpectedly.

Parameters

此方法不需要任何参数，传入空数组 [] 即可。

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "getbestblockhash",
8  "params": []
9}'

Errors & troubleshooting

Common pitfalls

• The tip moves roughly every ten minutes and can shift mid-reorg, so if you need a matching hash and height, read both close together and treat them as a single snapshot rather than calling getbestblockhash and getblockcount far apart.

Supported networks

• Mainnet
• Testnet

See also

• getblockcount
• getblockhash
• getblockchaininfo