RPC Browser

Arguments


Help Content

getbalance ( "dummy" minconf include_watchonly avoid_reuse )

Returns the total available balance.
The available balance is what the wallet considers currently spendable, and is
thus affected by options which limit spendability such as -spendzeroconfchange.

Arguments:
1. dummy                (string, optional) Remains for backward compatibility. Must be excluded or set to "*".
2. minconf              (numeric, optional, default=0) Only include transactions confirmed at least this many times.
3. include_watchonly    (boolean, optional, default=true for watch-only wallets, otherwise false) Also include balance in watch-only addresses (see 'importaddress')
4. avoid_reuse          (boolean, optional, default=true) (only available if avoid_reuse wallet flag is set) Do not include balance in dirty outputs; addresses are considered dirty if they have previously been used in a transaction.

Result:
n    (numeric) The total amount in BTC received for this wallet.

Examples:

The total amount in the wallet with 0 or more confirmations
> bitcoin-cli getbalance 

The total amount in the wallet with at least 6 confirmations
> bitcoin-cli getbalance "*" 6

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

dummy

{
    "name": "dummy",
    "detailsLines": [],
    "properties": [
        "string",
        "optional"
    ],
    "description": "Remains for backward compatibility. Must be excluded or set to \"*\"."
}

minconf

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

include_watchonly

{
    "name": "include_watchonly",
    "detailsLines": [],
    "properties": [
        "boolean",
        "optional",
        "default=true for watch-only wallets",
        "otherwise false"
    ],
    "description": "Also include balance in watch-only addresses (see 'importaddress')"
}

avoid_reuse

{
    "name": "avoid_reuse",
    "detailsLines": [],
    "properties": [
        "boolean",
        "optional",
        "default=true"
    ],
    "description": "(only available if avoid_reuse wallet flag is set) Do not include balance in dirty outputs; addresses are considered dirty if they have previously been used in a transaction."
}

Recent (1)

Blockchain (25)

Control (6)

Generating (3)

Mining (6)

Network (13)

Rawtransactions (17)

Signer (1)

Util (8)

Wallet (61)

Zmq (1)