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

# wallet.balance.updated

> Sent when a wallet's balances are synced

## wallet.balance.updated

Fired when Bluvo completes a balance sync for a connected wallet. This happens after initial wallet connection and during periodic background refreshes.

### When this event is sent

* Immediately after a wallet is first connected (following `wallet.created`)
* During periodic background balance syncs

### Payload

```json Example payload theme={null}
{
  "event": "wallet.balance.updated",
  "eventId": "wal_abc123-balance-1713700800000",
  "timestamp": "2026-04-21T12:00:00.000Z",
  "data": {
    "wallet": {
      "id": "wal_abc123",
      "projectId": "proj_xyz",
      "exchange": "coinbase"
    },
    "balances": {
      "BTC": { "total": 0.5 },
      "ETH": { "total": 10.25 }
    }
  }
}
```

### Fields

| Field                        | Type     | Description                           |
| ---------------------------- | -------- | ------------------------------------- |
| `data.wallet.id`             | `string` | Unique wallet identifier              |
| `data.wallet.projectId`      | `string` | Project the wallet belongs to         |
| `data.wallet.exchange`       | `string` | Exchange identifier                   |
| `data.balances`              | `object` | Map of asset ticker to balance object |
| `data.balances[asset].total` | `number` | Total balance for the asset           |

<Info>
  The `balances` object only includes assets with a non-zero balance. If a previously held asset is fully withdrawn, it will be absent from the next update.
</Info>