> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# onHoldersUpdated

> Live-streamed list of wallets that hold a given token, with the token's unique holder count.

<Note>
  Subscriptions use `wss://graphql.mobula.io/graphql` with the `graphql-transport-ws` protocol. `wss://graphql.mobula.io/graphql/subscriptions` is also supported for backwards compatibility.
</Note>

### Returns

<ResponseField name="onHoldersUpdated" type="HoldersUpdate">
  A batched holders update for the subscribed token, emitted whenever balances change. See [HoldersUpdate](/api-reference/graphql/types/HoldersUpdate).
</ResponseField>

### Arguments

<ResponseField name="tokenId" type="String!" required>
  Token identifier in `<tokenAddress>:<networkId>` form (e.g. `0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1`).
</ResponseField>

### Example

```graphql theme={null}
subscription {
  onHoldersUpdated(tokenId: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1") {
    holders
    tokenId
    tokenAddress
    networkId
    balances {
      address
      balance
      shiftedBalance
      balanceUsd
      firstHeldTimestamp
    }
  }
}
```