waitfornewblock (hidden command)

Bitcoin Core 25.1 RPC

waitfornewblock ( timeout )

Waits for a specific new block and returns useful info about it.

Returns the current block on timeout or exit.

Arguments

1. timeout    (numeric, optional, default=0) Time in milliseconds to wait for a response. 0 indicates no timeout.

Result

{                    (json object)
  "hash" : "hex",    (string) The blockhash
  "height" : n       (numeric) Block height
}

Examples

> bitcoin-cli waitfornewblock 1000
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "waitfornewblock", "params": [1000]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/