Documentation exported from Bitcoin Core 0.17.99

listreceivedbylabel (0.17.99 RPC)

blockchain

control

generating

mining

network

rawtransactions

util

wallet

listreceivedbylabel ( minconf include_empty include_watchonly)

List received transactions by label.

Arguments

1. minconf

numeric

optional

default=1

The minimum number of confirmations before payments are included.

2. include_empty

bool

optional

default=false

Whether to include labels that haven’t received any payments.

3. include_watchonly

bool

optional

default=false

Whether to include watch-only addresses (see ‘importaddress’).

Result

[
  {
    "involvesWatchonly" : true,

bool

Only returned if imported addresses were involved in transaction

    "amount" : x.xxx,

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 “”.

  }
  ,...
]

Examples

Examples:

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;' http://127.0.0.1:8332/