Documentation exported from Bitcoin Core 28.0

rescanblockchain (28.0.0 RPC)

blockchain

control

mining

network

rawtransactions

signer

util

wallet

zmq

rescanblockchain ( start_height stop_height )

Rescan the local blockchain for wallet related transactions.
Note: Use "getwalletinfo" to query the scanning progress.
The rescan is significantly faster when used on a descriptor wallet
and block filters are available (using startup option "-blockfilterindex=1").

Arguments:
1. start_height    (numeric, optional, default=0) block height where the rescan should start
2. stop_height     (numeric, optional) the last block height that should be scanned. If none is provided it will rescan up to the tip at return time of this call.

Result:
{                        (json object)
  "start_height" : n,    (numeric) The block height where the rescan started (the requested height or 0)
  "stop_height" : n      (numeric) The height of the last rescanned block. May be null in rare cases if there was a reorg and the call didn't scan any blocks because they were already scanned in the background.
}

Examples:
> bitcoin-cli rescanblockchain 100000 120000
> curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "rescanblockchain", "params": [100000, 120000]}' -H 'content-type: application/json' http://127.0.0.1:8332/