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

Example payload

{
  "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

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.

wallet.created wallet.deleted

Overview

Events

wallet.balance.updated

wallet.balance.updated

When this event is sent

Payload

Fields

​wallet.balance.updated

​When this event is sent

​Payload

​Fields

wallet.balance.updated

When this event is sent

Payload

Fields