listunspent ( minconf maxconf ["address",...] include_unsafe query_options )
Returns array of unspent transaction outputs
with between minconf and maxconf (inclusive) confirmations.
Optionally filter to only include txouts paid to specified addresses.
Arguments:
1. minconf (numeric, optional, default=1) The minimum confirmations to filter
2. maxconf (numeric, optional, default=9999999) The maximum confirmations to filter
3. addresses (json array, optional, default=[]) The bitcoin addresses to filter
[
"address", (string) bitcoin address
...
]
4. include_unsafe (boolean, optional, default=true) Include outputs that are not safe to spend
See description of "safe" attribute below.
5. query_options (json object, optional) Options object that can be used to pass named arguments, listed below. JSON with query options
Named Arguments:
minimumAmount (numeric or string, optional, default="0.00") Minimum value of each UTXO in XEC
maximumAmount (numeric or string, optional, default=unlimited) Maximum value of each UTXO in XEC
maximumCount (numeric, optional, default=unlimited) Maximum number of UTXOs
minimumSumAmount (numeric or string, optional, default=unlimited) Minimum sum value of all UTXOs in XEC
Result:
[ (json array)
{ (json object)
"txid" : "hex", (string) the transaction id
"vout" : n, (numeric) the vout value
"address" : "str", (string) the bitcoin address
"label" : "str", (string) The associated label, or "" for the default label
"scriptPubKey" : "str", (string) the script key
"amount" : n, (numeric) the transaction output amount in XEC
"confirmations" : n, (numeric) The number of confirmations
"ancestorcount" : n, (numeric, optional) DEPRECATED: The number of in-mempool ancestor transactions, including this one (if transaction is in the mempool). Only displayed if the -deprecatedrpc=mempool_ancestors_descendants option is set
"ancestorsize" : n, (numeric, optional) DEPRECATED: The virtual transaction size of in-mempool ancestors, including this one (if transaction is in the mempool). Only displayed if the -deprecatedrpc=mempool_ancestors_descendants option is set
"ancestorfees" : n, (numeric, optional) DEPRECATED: The total fees of in-mempool ancestors (including this one) with fee deltas used for mining priority in XEC (if transaction is in the mempool). Only displayed if the -deprecatedrpc=mempool_ancestors_descendants option is set
"redeemScript" : "hex", (string) The redeemScript if scriptPubKey is P2SH
"spendable" : true|false, (boolean) Whether we have the private keys to spend this output
"solvable" : true|false, (boolean) Whether we know how to spend this output, ignoring the lack of keys
"reused" : true|false, (boolean) (only present if avoid_reuse is set) Whether this output is reused/dirty (sent to an address that was previously spent from)
"desc" : "str", (string) (only when solvable) A descriptor for spending this output
"safe" : true|false (boolean) Whether this output is considered safe to spend. Unconfirmed transactions
from outside keys are considered unsafe
and are not eligible for spending by fundrawtransaction and sendtoaddress.
},
...
]
Examples:
> bitcoin-cli listunspent
> bitcoin-cli listunspent 6 9999999 "[\"1PGFqEzfmQch1gKD3ra4k18PNj3tTUUSqg\",\"1LtvqCaApEdUGFkpKMM4MstjcaL4dKg8SP\"]"
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "listunspent", "params": [6, 9999999 "[\"1PGFqEzfmQch1gKD3ra4k18PNj3tTUUSqg\",\"1LtvqCaApEdUGFkpKMM4MstjcaL4dKg8SP\"]"]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/
> bitcoin-cli listunspent 6 9999999 '[]' true '{ "minimumAmount": 0.005 }'
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "listunspent", "params": [6, 9999999, [] , true, { "minimumAmount": 0.005 } ]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/