bitcoin-cliコマンド【getbalance】

2018-11-02

getbalance ( “(dummy)” minconf include_watchonly )

利用可能な合計残高を返却する。

利用可能な残高は、コマンドを実行した時点でウォレット内の消費可能な残高となるので、 -spendzeroconfchange(bitcoind起動時のオプション)のような消費可能となるまでの confirm 数を制限するオプションにより変化する。

引数

① dummy (string, optional)

下位互換のためのdummy。後続の引数を指定する場合は、第1引数に “*” を指定する必要がある。

② minconf (numeric, optional, default=0) 

ここで指定した confirm 数以上のトランザクションを対象とする。

③ include_watchonly (bool, optional, default=false)

watch-only アドレスも残高に含める場合は “true” を指定する。

実行例

$ bitcoin-cli -regtest getbalance
100.00000000

$ bitcoin-cli -regtest getbalance "*" 102 true
50.00000000

$ bitcoin-cli -regtest getbalance "*" 103 true
0.00000000

出力内容

amount (numeric)

このアカウントで受信したBTCの全残高