listreceivedbyaddress¶

listreceivedbyaddress ( minconf include_empty include_watchonly "address_filter" )

List balances by receiving address.

Argument #1 - minconf¶

Type: numeric, optional, default=1

The minimum number of confirmations before payments are included.

Argument #2 - include_empty¶

Type: boolean, optional, default=false

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

Argument #3 - include_watchonly¶

Type: boolean, optional, default=false

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

Argument #4 - address_filter¶

Type: string, optional

If present, only return information on this address.

Result¶

[
  {
    "involvesWatchonly" : true,        (bool) Only returned if imported addresses were involved in transaction
    "address" : "receivingaddress",  (string) The receiving address
    "amount" : x.xxx,                  (numeric) The total amount in BTC received by the address
    "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 "".
    "txids": [
       "txid",                         (string) The ids of transactions received with the address
       ...
    ]
  }
  ,...
]

Examples¶

bitcoin-cli listreceivedbyaddress

bitcoin-cli listreceivedbyaddress 6 true

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listreceivedbyaddress", "params": [6, true, true] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/

curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "listreceivedbyaddress", "params": [6, true, true, "1M72Sfpbz1BPpXFHz9m3CdqATR44Jvaydd"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/

Table Of Contents

Previous topic

Next topic