Skip to main content

​
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

FieldTypeDescription
data.wallet.idstringUnique wallet identifier
data.wallet.projectIdstringProject the wallet belongs to
data.wallet.exchangestringExchange identifier
data.balancesobjectMap of asset ticker to balance object
data.balances[asset].totalnumberTotal 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.