getreceivedbyaddress

Back to wallet

Wallet

Summary

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

Description

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

Arguments

  • address (STR, required): The qbit address for transactions.
  • minconf (NUM): Only include transactions confirmed at least this many times.
  • include_immature_coinbase (BOOL): Include immature coinbase transactions.

Results

  • amount (STR_AMOUNT): The total amount in QBT received at this address.

Examples

The amount from transactions with at least 1 confirmation
qbit-cli getreceivedbyaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw"
The amount including unconfirmed transactions, zero confirmations
qbit-cli getreceivedbyaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" 0
The amount with at least 6 confirmations
qbit-cli getreceivedbyaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" 6
The amount with at least 6 confirmations including immature coinbase outputs
qbit-cli getreceivedbyaddress "qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw" 6 true
As a JSON-RPC call
curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "getreceivedbyaddress", "params": ["qb1zqqqsyqcyq5rqwzqfpg9scrgwpugpzysnzs23v9ccrydpk8qarc0sjq57mw", 6]}' -H 'content-type: application/json' http://127.0.0.1:8352/