<p><code>listaddressgroupings</code> 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.</p>

<p>Let me explain:</p>

<p>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.  </p>

<p>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.</p>

<p><code>listaddressgroupings</code> 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.</p>

CC BY-SA 3.0
2014-05-22T20:41:38.253Z
2014-05-22T20:41:38.253Z
Eric S
<p>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.</p>

CC BY-SA 3.0
2014-07-27T06:06:42.493Z
2014-07-27T06:06:42.493Z
merockstar
<p>Can anyone please explain the <code>listaddressgroupings</code> rpc method? Its documentation isn't clear in Bitcoin Core</p>

<pre><code>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

Result:
[
  [
    [
      "bitcoinaddress",     (string) The bitcoin address
      amount,                 (numeric) The amount in btc
      "account"             (string, optional) The account
    ]
    ,...
  ]
  ,...
]
</code></pre>

<p>????</p>

<bitcoind><json-rpc>
What does the listaddressgroupings rpc method do?
Farghaly
# What does the listaddressgroupings rpc method do?

(Asked by: username_0 on 2014-05-20)

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

Result:
[
  [
    [
      "bitcoinaddress",     (string) The bitcoin address
      amount,                 (numeric) The amount in btc
      "account"             (string, optional) The account
    ]
    ,...
  ]
  ,...
]

```

????

**Tags:** bitcoind, json-rpc


---

## 2 answers

### Answer by username_1 on 2014-05-22. Score: 5

`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.


---

### Answer by username_2 on 2014-07-27. Score: 0

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.


---

