bitcoind.app
CommandsGuidesContact ↗
Home/Blockchain/scanblocks
Blockchain

scanblocks

Return relevant blockhashes for given descriptors. Requires -blockfilterindex.

Parameters

actionstringREQUIRED
"start", "abort", or "status"
scanobjectsarrayoptional
Array of scan descriptors
start_heightnumberoptional
Start height. Default: 0
stop_heightnumberoptional
Stop height. Default: chain tip
filtertypestringoptional
Filter type. Default: "basic"

Returns

objectScan results with relevant blocks

Code Examples

curl --user myuser --data-binary '{"jsonrpc":"1.0","id":"1","method":"scanblocks","params":["start",["addr(bc1q...)"]]}' -H 'content-type:text/plain;' http://127.0.0.1:8332/

Example Response

{
  "from_height": 0,
  "to_height": 840000,
  "relevant_blocks": [
    "00000000000000000002...",
    "00000000000000000003..."
  ]
}
← Previous
getdeploymentinfo
Next →
scantxoutset

More Blockchain Commands

getbestblockhashgetblockgetblockchaininfogetblockcountgetblockfiltergetblockhash

bitcoind.app — Bitcoin Core RPC Reference

GuidesContact ↗