onBalanceUpdated

​

Example

subscription {
  onBalanceUpdated(
    walletAddress: "0xADDRESS"
    networks: [1, 8453]
    excludeTokens: ["native"]
  ) {
    walletId
    tokenId
    networkId
    balance
    shiftedBalance
    updatedAtBlock
    token {
      name
      symbol
    }
  }
}

​

Usage Guidelines

• Without arguments the stream covers every network, including native balances (tokenAddress of native) and wrapped SOL, which arrive as separate rows.
• An update is sent each time one of the wallet’s balance rows is written. Price changes alone don’t send updates.
• Use networks to limit updates to specific network IDs, and excludeTokens to skip up to 200 tokens. A bare address excludes the token on every network, address:networkId on one network, and native or native:<networkId> excludes native balances. To drop SOL entirely, exclude both native and the wrapped SOL mint.
• Updates left out by networks or excludeTokens are not sent and not charged.
• tokenPriceUsd and balanceUsd on streamed updates can be stale for the life of the connection. For current USD values, read balances or getTokenPrices.
• On Solana, a token held across several token accounts can briefly stream a partial amount, such as 0, before the next update corrects it. Confirm with balances when it matters.