getbalances (wallet command)

Bitcoin Core 26.1 RPC

getbalances

Returns an object with all balances in BTC.

Result

{                               (json object)
  "mine" : {                    (json object) balances from outputs that the wallet can sign
    "trusted" : n,              (numeric) trusted balance (outputs created by the wallet or confirmed outputs)
    "untrusted_pending" : n,    (numeric) untrusted pending balance (outputs created by others that are in the mempool)
    "immature" : n,             (numeric) balance from immature coinbase outputs
    "used" : n                  (numeric, optional) (only present if avoid_reuse is set) balance from coins sent to addresses that were previously spent from (potentially privacy violating)
  },
  "watchonly" : {               (json object, optional) watchonly balances (not present if wallet does not watch anything)
    "trusted" : n,              (numeric) trusted balance (outputs created by the wallet or confirmed outputs)
    "untrusted_pending" : n,    (numeric) untrusted pending balance (outputs created by others that are in the mempool)
    "immature" : n              (numeric) balance from immature coinbase outputs
  },
  "lastprocessedblock" : {      (json object) hash and height of the block this information was generated on
    "hash" : "hex",             (string) hash of the block this information was generated on
    "height" : n                (numeric) height of the block this information was generated on
  }
}

Examples

> bitcoin-cli getbalances 
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getbalances", "params": []}' -H 'content-type: text/plain;' http://127.0.0.1:8332/