bitcoin core logo

listreceivedbylabel

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=true for watch-only wallets, otherwise false) Whether to include watch-only addresses (see ‘importaddress’)
  4. include_immature_coinbase (boolean, optional, default=false) Include immature coinbase transactions.

Result: [ (json array) { (json object) “involvesWatchonly” : true|false, (boolean, optional) Only returns true if imported addresses were involved in transaction “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/