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

# onBalanceUpdated

> Subscribe to real-time token balance changes for a single wallet address across all supported chains.

### Returns

<ResponseField name="onBalanceUpdated" type="Balance!">
  A stream of balance updates for the subscribed wallet. One event is pushed per token balance change. See [Balance](/api-reference/graphql/types/Balance).
</ResponseField>

### Arguments

<ResponseField name="walletAddress" type="String!" required>
  The wallet address to stream balance updates for. Must be a valid address; invalid inputs return `BAD_USER_INPUT`. EVM addresses are normalized internally for matching.
</ResponseField>

### Example

```graphql theme={null}
subscription OnBalanceUpdated {
  onBalanceUpdated(walletAddress: "0xBa616F6b873a51a6dE9c72181BBeF9cA45488D94") {
    address
    networkId
    tokenAddress
    balance
    shiftedBalance
    balanceUsd
    tokenPriceUsd
    firstHeldTimestamp
    liquidityUsd
    token {
      name
      symbol
      logo
    }
  }
}
```