Skip to content

listreceivedbylabel JSON-RPC command

listreceivedbylabel ( minconf include_empty include_watchonly )

List received transactions by label.


1. minconf              (numeric, optional, default=1) The minimum number of confirmations before payments are included.
2. include_empty        (boolean, optional, default=false) Whether to include labels that haven't received any payments.
3. include_watchonly    (boolean, optional, default=false) Whether to include watch-only addresses (see 'importaddress').


    "involvesWatchonly" : true,   (bool) Only returned if imported addresses were involved in transaction
    "amount" :,             (numeric) The total amount received by addresses with this label
    "confirmations" : n,          (numeric) The number of confirmations of the most recent transaction included
    "label" : "label"           (string) The label of the receiving address. The default label is "".


> bitcoin-cli listreceivedbylabel
> bitcoin-cli listreceivedbylabel 6 true
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listreceivedbylabel", "params": [6, true, true] }' -H 'content-type: text/plain;'

Bitcoin Cash Node Daemon version v27.0.1-7ef8bf2

Documentation on reflects the current master branch in Git, and may include API changes that are not yet present in the latest release.