Positions

Topic: /contract/positionAll

OR

Topic:/contract/position:XBTUSDTM

Description

You will receive this message when position changes.

These situations will cause position change

Position Changes Caused Operations. changeReason Descriptions:

“marginChange”: margin change;

“positionChange”: position change;

“liquidation”: liquidation;

“autoAppendMarginStatusChange”: auto-deposit-status change;

“adl”: adl;

Funding Fee Settlement

Adjustment Isolated Margin Risk Limit Level. msg failure reasons:

the value of the holding position exceeds the limit amount of the risk limit level;

insufficient balance to increase the margin.

Push frequency: real-time

//Get all symbols position change
{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/contract/positionAll",
  "response": true,
  "privateChannel": "true"
}

//Get specific symbol position change
{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/contract/position:XBTUSDTM",
  "response": true,
  "privateChannel": "true"
}

Response

Data Schema

position

Example

1. Position Changes Caused Operations

//Isolated Margin
{
    "topic": "/contract/position:XBTUSDTM",
    "type": "message",
    "data": {
        "symbol": "XBTUSDTM",
        "maintMarginReq": 0.005,
        "riskLimit": 500000,
        "realLeverage": 4.9685590767,
        "crossMode": false,
        "delevPercentage": 0.10,
        "openingTimestamp": 1731916913097,
        "autoDeposit": true,
        "currentTimestamp": 1731924561514,
        "currentQty": 1,
        "currentCost": 91.5306,
        "currentComm": 0.09179284,
        "unrealisedCost": 91.6945,
        "realisedCost": -0.07210716,
        "isOpen": true,
        "markPrice": 91839.79,
        "markValue": 91.83979,
        "posCost": 91.6945,
        "posCross": 0,
        "posInit": 18.3389,
        "posComm": 0.06602004,
        "posLoss": 0,
        "posMargin": 18.40492004,
        "posFunding": 0,
        "posMaint": 0.5634627025,
        "maintMargin": 18.55021004,
        "avgEntryPrice": 91694.5,
        "liquidationPrice": 73853.0426625,
        "bankruptPrice": 73355.6,
        "settleCurrency": "USDT",
        "changeReason": "positionChange",
        "riskLimitLevel": 2,
        "realisedGrossCost": -0.1639,
        "realisedGrossPnl": 0.1639,
        "realisedPnl": 0.07210716,
        "unrealisedPnl": 0.14529,
        "unrealisedPnlPcnt": 0.0016,
        "unrealisedRoePcnt": 0.0079,
        "leverage": 4.9685590767,
        "marginMode": "ISOLATED",
        "positionSide": "BOTH"
    },
    "subject": "position.change",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private"
}
      
//Cross Margin
{
    "topic": "/contract/position:XBTUSDTM",
    "type": "message",
    "data": {
        "symbol": "XBTUSDTM",
        "crossMode": true,
        "delevPercentage": 0.06,
        "openingTimestamp": 1717639498983,
        "currentTimestamp": 1717724686618,
        "currentQty": -2,
        "currentCost": -136.002,
        "currentComm": 0.06739824,
        "unrealisedCost": -136.002,
        "realisedCost": 0.06739824,
        "isOpen": true,
        "markPrice": 70778.04,
        "markValue": -141.55608,
        "posCost": -136.002,
        "posInit": 5.4509819612,
        "posMargin": 5.6735903779,
        "avgEntryPrice": 68001,
        "liquidationPrice": 80700.49720065,
        "bankruptPrice": 81152.42267235,
        "settleCurrency": "USDT",
        "changeReason": "positionChange",
        "realisedGrossCost": 0,
        "realisedGrossPnl": 0,
        "realisedPnl": -0.09580416,
        "unrealisedPnl": -5.55408,
        "unrealisedPnlPcnt": -0.0408,
        "unrealisedRoePcnt": -1.0189,
        "leverage": 24.95, 
        "marginMode": "CROSS", // CROSS，ISOLATED
        "positionSide": "BOTH"
    },
    "subject": "position.change",
    "userId": "665ec530aa70390001d22576",
    "channelType": "private"
}
      
2. Funding Fee Settlement
{
  "userId": "xbc453tg732eba53a88ggyt8c", // Deprecated, will detele later
  "topic": "/contract/position:XBTUSDM",
  "subject": "position.settlement",
  "data": {
    "fundingTime": 1551770400000, //Funding time
    "qty": 100, //Position size
    "markPrice": 3610.85, //Settlement price
    "fundingRate": -0.002966, //Funding rate
    "fundingFee": -296, //Funding fees
    "ts": 1547697294838004923, //Current time (nanosecond)
    "settleCurrency": "XBT" //Currency used to clear and settle the trades
  }
}
      
3. Adjustment Isolated margin Risk Limit Level
{
  "userId": "xbc453tg732eba53a88ggyt8c",
  "topic": "/contract/position:ADAUSDTM",
  "subject": "position.adjustRiskLimit",
  "data": {
    "success": true, // Successful or not
    "riskLimitLevel": 1, // Current risk limit level
    "msg": "" // Failure reason
  }
}

Topic: /contract/positionAll#

OR#

Topic:/contract/position:XBTUSDTM#

Subscribe Message#

Response#

Request

Topic: /contract/positionAll

OR

Topic:/contract/position:XBTUSDTM

Subscribe Message

Response