.. This file is licensed under the MIT License (MIT) available on
   http://opensource.org/licenses/MIT.

getbalance
==========

``getbalance ( "dummy" minconf include_watchonly )``

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.

Argument #1 - dummy
~~~~~~~~~~~~~~~~~~~

**Type:** string, optional

Remains for backward compatibility. Must be excluded or set to "*".

Argument #2 - minconf
~~~~~~~~~~~~~~~~~~~~~

**Type:** numeric, optional, default=0

Only include transactions confirmed at least this many times.

Argument #3 - include_watchonly
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Type:** boolean, optional, default=false

Also include balance in watch-only addresses (see 'importaddress')

Result
~~~~~~

.. list-table::
   :header-rows: 1

   * - Name
     - Type
     - Description
   * - amount
     - numeric
     - The total amount in BTC received for this wallet.

Examples
~~~~~~~~


.. highlight:: shell

The total amount in the wallet with 1 or more confirmations::

  bitcoin-cli getbalance

The total amount in the wallet at least 6 blocks confirmed::

  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/