getreceivedbyaddress (0.17.99 RPC)
blockchain
control
generating
mining
network
rawtransactions
util
wallet
getreceivedbyaddress "address" ( minconf )
Returns the total amount received by the given address in transactions with at least minconf confirmations.
Arguments
1. "address" |
string required |
The bitcoin address for transactions. |
2. minconf |
numeric optional default=1 |
Only include transactions confirmed at least this many times. |
Result
amount |
numeric |
The total amount in BTC received at this address. |
Examples
The amount from transactions with at least 1 confirmation
bitcoin-cli getreceivedbyaddress "1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX"
The amount including unconfirmed transactions, zero confirmations
bitcoin-cli getreceivedbyaddress "1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX" 0
The amount with at least 6 confirmations
bitcoin-cli getreceivedbyaddress "1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX" 6
As a json rpc call
curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "getreceivedbyaddress", "params": ["1D1ZrZNe3JUo7ZycKEYQQiQAWd9y54F4XX", 6] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/