Event: Balance and Position Update

Event Description

Event type is ACCOUNT_UPDATE.

• When balance or position get updated, this event will be pushed.

  • ACCOUNT_UPDATE will be pushed only when update happens on user's account, including changes on balances, positions, or margin type.
  • Unfilled orders or cancelled orders will not make the event ACCOUNT_UPDATE pushed, since there's no change on positions.
  • "position" in ACCOUNT_UPDATE: All symbols will be pushed.

• The field "m" represents the reason type for the event and may shows the following possible types:

  • DEPOSIT
  • WITHDRAW
  • ORDER
  • FUNDING_FEE
  • ADJUSTMENT
  • INSURANCE_CLEAR
  • ADMIN_DEPOSIT
  • ADMIN_WITHDRAW
  • MARGIN_TRANSFER
  • MARGIN_TYPE_CHANGE
  • ASSET_TRANSFER
  • COIN_SWAP_DEPOSIT
  • COIN_SWAP_WITHDRAW

• The field "bc" represents the balance change except for PnL and commission.

Event Name

ACCOUNT_UPDATE

Response Example

{
  "e": "ACCOUNT_UPDATE",			// Event Type
  "E": 1564745798939,            	// Event Time
  "T": 1564745798938 ,           	// Transaction
  "i": "SfsR",						// Account Alias
  "a":                          	// Update Data
    {
      "m":"ORDER",					// Event reason type
      "B":[                     	// Balances
        {
          "a":"BTC",           	    // Asset
          "wb":"122624.12345678",   // Wallet Balance
          "cw":"100.12345678",		// Cross Wallet Balance
          "bc":"50.12345678"			// Balance Change except PnL and Commission
        },
        {
          "a":"ETH",           
          "wb":"1.00000000",
          "cw":"0.00000000",
          "bc":"-49.12345678"
        }
      ],
      "P":[
        {
          "s":"BTCUSD_200925",      // Symbol
          "pa":"0",               	// Position Amount
          "ep":"0.0",               // Entry Price
          "bep":"0.0",               // Break-Even Price 
          "cr":"200",             	// (Pre-fee) Accumulated Realized
          "up":"0",					// Unrealized PnL
          "mt":"isolated",			// Margin Type
          "iw":"0.00000000",		// Isolated Wallet (if isolated position)
          "ps":"BOTH"				// Position Side
        },
        {
        	"s":"BTCUSD_200925",
        	"pa":"20",
        	"ep":"6563.6",
            "bep":"6563.7",
        	"cr":"0",
        	"up":"2850.21200000",
        	"mt":"isolated",
        	"iw":"13200.70726908",
        	"ps":"LONG"
      	 },
        {
        	"s":"BTCUSD_200925",
        	"pa":"-10",
        	"ep":"6563.8"
            "bep":"6563.6",,
        	"cr":"-45.04000000",
        	"up":"-1423.15600000",
        	"mt":"isolated",
        	"iw":"6570.42511771",
        	"ps":"SHORT"
        }
      ]
    }
}