getreceivedbylabel

Back to wallet

Wallet

Summary

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

Description

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

Arguments

• label (STR, required): The selected label, may be the default label using "".
• minconf (NUM): Only include transactions confirmed at least this many times.
• include_immature_coinbase (BOOL): Include immature coinbase transactions.

Results

• amount (STR_AMOUNT): The total amount in QBT received for this label.

Examples

Amount received by the default label with at least 1 confirmation

qbit-cli getreceivedbylabel ""

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

qbit-cli getreceivedbylabel "tabby" 0

The amount with at least 6 confirmations

qbit-cli getreceivedbylabel "tabby" 6

The amount with at least 6 confirmations including immature coinbase outputs

qbit-cli getreceivedbylabel "tabby" 6 true

As a JSON-RPC call

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getreceivedbylabel", "params": ["tabby", 6, true]}' -H 'content-type: application/json' http://127.0.0.1:8352/