Can anyone please explain the listaddressgroupings rpc method? Its documentation isn't clear in Bitcoin Core

Lists groups of addresses which have had their common ownership
made public by common use as inputs or as the resulting change
in past transactions

      "bitcoinaddress",     (string) The bitcoin address
      amount,                 (numeric) The amount in btc
      "account"             (string, optional) The account


2 Answers 2


listaddressgroupings is a RPC call that really could have been left an internal method, but the core devs decided to expose it in order to give users more control and awareness of Bitcoin's privacy issues.

Let me explain:

As you probably know, when you make a purchase, the bitcoind or bitcoin-qt client (which both use bitcoin-core) return your change by default to a new address. Well, if decide to use that address for another transaction, you have created a chain of "connectable" transactions. If you're not careful, there are various other ways that you can create connected transactions (like always using the same receiving address). However, if you already generate a new address to receive Bitcoins, this isn't a problem.

There are already numerous programs available that have the ability to scan the blockchain and list such connected transaction chains, which are definite proof that the addresses in question are or have been in the same wallet.

listaddressgroupings is a method that allow users to have the same ability to discern which groups of their addresses are connected on the public blockchain. It allows users to use the (relatively) new coin control functionality with greater awareness of potential privacy-revealing issues.


This is a super useful method for people who own angelshares. It allow's them to see every address that could possible have been credited AGS, including change addresses. That way they can dumpprivkey and import them into a new DAC.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.