RPC Browser

Arguments


Help Content

getreceivedbylabel "label" ( minconf include_immature_coinbase )

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

Arguments:
1. label                        (string, required) The selected label, may be the default label using "".
2. minconf                      (numeric, optional, default=1) Only include transactions confirmed at least this many times.
3. include_immature_coinbase    (boolean, optional, default=false) Include immature coinbase transactions.

Result:
n    (numeric) The total amount in BC2 received for this label.

Examples:

Amount received by the default label with at least 1 confirmation
> bitcoinII-cli getreceivedbylabel ""

Amount received at the tabby label including unconfirmed amounts with zero confirmations
> bitcoinII-cli getreceivedbylabel "tabby" 0

The amount with at least 6 confirmations
> bitcoinII-cli getreceivedbylabel "tabby" 6

The amount with at least 6 confirmations including immature coinbase outputs
> bitcoinII-cli getreceivedbylabel "tabby" 6 true

As a JSON-RPC call
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getreceivedbylabel", "params": ["tabby", 6, true]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/

label

{
    "name": "label",
    "detailsLines": [],
    "properties": [
        "string",
        "required"
    ],
    "description": "The selected label, may be the default label using \"\"."
}

minconf

{
    "name": "minconf",
    "detailsLines": [],
    "properties": [
        "numeric",
        "optional",
        "default=1"
    ],
    "description": "Only include transactions confirmed at least this many times."
}

include_immature_coinbase

{
    "name": "include_immature_coinbase",
    "detailsLines": [],
    "properties": [
        "boolean",
        "optional",
        "default=false"
    ],
    "description": "Include immature coinbase transactions."
}

Recent (1)

Blockchain (33)

Control (6)

Mining (7)

Network (14)

Rawtransactions (19)

Signer (1)

Util (8)

Wallet (66)

Zmq (1)