Returns A stream of balance updates for the subscribed wallet. One event is pushed per token balance change. See BalanceUpdate . Show View fields (BalanceUpdate)
Normalized wallet identifier.
Token identifier in <tokenAddress>:<networkId> form.
Wallet address that the update belongs to.
Contract address of the token whose balance changed.
Raw on-chain balance as a decimal string (no decimal shift applied).
Human-readable balance (balance shifted by the token’s decimals).
USD value of the position at the time of the update. Null when pricing is unavailable.
Unit price of the token in USD at the time of the update. Null when pricing is unavailable.
Unix timestamp (seconds) of when this wallet first acquired the token.
Full token metadata (name, symbol, logo, etc.). Only fetched when the client selects the
token field. See
EnhancedToken .
USD liquidity for the primary pool of the token. Null when liquidity data is unavailable.
Arguments 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.
Example subscription OnBalanceUpdated { onBalanceUpdated ( walletAddress : "0xBa616F6b873a51a6dE9c72181BBeF9cA45488D94" ) { address networkId tokenAddress balance shiftedBalance balanceUsd tokenPriceUsd firstHeldTimestamp liquidityUsd token { name symbol logo } } }
