Positions Channel

Code
{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "position"
        }
    ]
}

Request Parameters

Parameters	Type	Description
op	String	Operation subscribe Subscribe unsubscribe Unsubscribe
args	List<Object>	Subscribed channel
> instType	String	Product type UTA Unified trading account
> topic	String	Topic position Position

Code
{
  "event": "subscribe",
  "arg": {
    "instType": "UTA",
    "topic": "position"
  },
  "code": "",
  "msg": "",
  "connId": "xxxxxxxxxx"
}

Response Parameters

Parameters	Type	Description
event	String	Operation subscribe Subscription unsubscribe Unsubscription error Parameter error
arg	Object	Subscribed channel
> instType	String	Product type UTA Unified trading account
> topic	String	Topic position Position
code	String	Error code
msg	String	Error message
connId	String	Connection ID

Code
{
  "data": [
    {
      "symbol": "BTCUSDT",
      "leverage": "20",
      "openFeeTotal": "",
      "mmr": "",
      "breakEvenPrice": "",
      "available": "0",
      "liqPrice": "",
      "marginMode": "crossed",
      "unrealisedPnl": "0",
      "markPrice": "94987.1",
      "createdTime": "1736378720620",
      "avgPrice": "0",
      "totalFundingFee": "0",
      "cashDividend": "0",
      "updatedTime": "1736378720620",
      "marginCoin": "USDT",
      "frozen": "0",
      "profitRate": "",
      "closeFeeTotal": "",
      "marginSize": "0",
      "curRealisedPnl": "0",
      "size": "0",
      "positionStatus": "ended",
      "posSide": "long",
      "holdMode": "hedge_mode"
    }
  ],
  "arg": {
    "instType": "UTA",
    "topic": "position"
  },
  "action": "snapshot",
  "ts": 1730711666652
}

Push Parameters

Parameter	Type	Description
arg	Object	Subscribed channel
> instType	String	Product type UTA Unified Account
> topic	String	Topic position Position channel
action	String	Action snapshot Full data update Incremental data
data	List<Object>	Subscribed data
> symbol	String	Symbol name
> marginCoin	String	Margin coin
> marginSize	String	Margin size
> marginMode	String	Margin mode crossed Cross margin isolated Isolated margin
> posSide	String	Position side long/short
> holdMode	String	Holding mode one_way_mode/hedge_mode
> positionStatus	String	Position status opening Ongoing ended Completed
> size	String	Position size size = available + frozen
> available	String	Available position size
> frozen	String	Frozen position size
> avgPrice	String	Average open price
> leverage	String	Leverage multiple
> curRealisedPnl	String	Realised PnL
> unrealisedPnl	String	Unrealised PnL
> liqPrice	String	Estimated liquidation price
> mmr	String	Maintain margin rate
> marginRate	String	Margin rate
> markPrice	String	Mark Price
> openFeeTotal	String	Total opening fee
> closeFeeTotal	String	Total closing fee
> breakEvenPrice	String	Break-even price
> profitRate	String	Profit rate Profit rate = Unrealized PnL ÷ Initial margin Initial margin = Average open price × Position size ÷ Leverage ÷ Margin coin index price
> totalFundingFee	String	Total funding fee over the position's lifetime 0 indicates that no funding fee has been charged yet
> cashDividend	String	Cash dividend, unit: USDT
> createdTime	String	Position creation time A Unix timestamp in milliseconds. e.g.,1597026383085
> updatedTime	String	Latest position update time A Unix timestamp in milliseconds. e.g.,1597026383085

Profit Rate Calculation

Profit Rate = Unrealized PnL / Initial Margin

Initial Margin

Initial Margin = (Average Open Price × Position Size) / Leverage / Margin Coin Index Price