Documentation exported from Bitcoin Core 30.0

listreceivedbylabel (30.0.0 RPC)

blockchain

control

mining

network

rawtransactions

signer

util

wallet

zmq

listreceivedbylabel ( minconf include_empty include_watchonly include_immature_coinbase )

List received transactions by label.

Arguments:
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) (DEPRECATED) No longer used
4. include_immature_coinbase    (boolean, optional, default=false) Include immature coinbase transactions.

Result:
[                           (json array)
  {                         (json object)
    "amount" : n,           (numeric) The total amount received by addresses with this label
    "confirmations" : n,    (numeric) The number of confirmations of the most recent transaction included
    "label" : "str"         (string) The label of the receiving address. The default label is ""
  },
  ...
]

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