Skip to main content

Balance Updates (Private)

Automatically subscribed after successful authentication, pushes user futures account balance changes.

  • Channel: balance
  • Push Frequency: Real-time, unthrottled
  • Access: Private (auth required)

Authentication

Use the standard HmacSHA256 WebSocket login request described in Common Module · WebSocket Interface.

After successful authentication, order, balance, and position are subscribed automatically.

Push Example

{
"ch": "balance",
"d": {
"e": "balanceUpdate",
"E": 1768205315166,
"a": "USDT",
"d": "100.50",
"T": 1768205315166
}
}

Push Fields

FieldTypeDescription
estringEvent type, fixed as "balanceUpdate"
EnumberEvent time (milliseconds)
astringAsset name
dstringBalance delta (positive or negative)
TnumberSettlement time (milliseconds)