Table Of Contents

Previous topic

getrawchangeaddress

Next topic

getreceivedbylabel

getreceivedbyaddress

getreceivedbyaddress "address" ( minconf )

Returns the total amount received by the given address in transactions with at least minconf confirmations.

Argument #1 - address

Type: string, required

The bitcoin address for transactions.

Argument #2 - minconf

Type: numeric, optional, default=1

Only include transactions confirmed at least this many times.

Result

Name Type Description
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/