Skip to main content

getreceivedbylabel

getreceivedbylabel "label" ( minconf )

Returns the total amount received by addresses with label in transactions with at least [minconf] confirmations.

Argument #1 - label

Type: string, required

The selected label, may be the default label using "".

Argument #2 - minconf

Type: numeric, optional, default=1

Only include transactions confirmed at least this many times.

Result

NameTypeDescription
nnumericThe total amount in BGL received for this label.

Example usage (with RPC call)

Amount received by the default label with at least 1 confirmation:

BGL-cli getreceivedbylabel ""

Amount received at the tabby label including unconfirmed amounts with zero confirmations:

BGL-cli getreceivedbylabel "tabby" 0

The amount with at least 6 confirmations:

BGL-cli getreceivedbylabel "tabby" 6

As a JSON-RPC call:

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