持仓频道

描述

订阅仓位频道

请求参数

参数名	参数类型	是否必须	描述
event	String	是	操作, subscribe unsubscribe
channel	String	是	频道名

请求示例

{
  "event": "subscribe",
  "channel": "positions"
}

返回参数

返回字段	参数类型	字段说明
event	String	操作, subscribed unsubscribed
channel	String	频道名

订阅返回示例

{
  "event": "subscribed",
  "channel": "positions"
}

推送数据参数

返回字段	参数类型	字段说明
id	String	仓位id
coinId	String	所属抵押品币种id
contractId	String	所属合约id
side	String	持仓方向
marginMode	String	当前仓位的保证金模式
separatedMode	String	当前仓位的分仓模式
separatedOpenOrderId	String	分仓开仓委托单id
leverage	String	仓位杠杆
size	String	持有数量
openValue	String	开仓价值
openFee	String	开仓手续费用
fundingFee	String	资金费用
isolatedMargin	String	逐仓保证金
isAutoAppendIsolatedMargin	String	是否自动追加逐仓保证金
cumOpenSize	String	累计开仓数量
cumOpenValue	String	累计开仓价值
cumOpenFee	String	累计开仓费用
cumCloseSize	String	累计平仓数量
cumCloseValue	String	累计平仓价值
cumCloseFee	String	累计平仓费用
cumFundingFee	String	累计已结算的资金费用
cumLiquidateFee	String	累计清算(强平)费用
createdMatchSequenceId	String	创建时对应撮合引擎处理序号
updatedMatchSequenceId	String	更新时对应撮合引擎处理序号
createdTime	String	创建时间 (timestamp)
updatedTime	String	更新时间 (timestamp)

推送返回示例

{
  "type": "trade-event",
  "channel": "positions",
  "event": "payload",
  "msg": {
    "msgEvent": "PositionFundingSettle",
    "version": 46571,
    "data": {
      "position": [
        {
          "id": "615193369903104410",
          "coinId": "USDT",
          "contractId": "cmt_btcusdt",
          "side": "LONG",
          "marginMode": "SHARED",
          "separatedMode": "COMBINED",
          "separatedOpenOrderId": "0",
          "leverage": "20",
          "size": "0.01000",
          "openValue": "992.405443",
          "openFee": "0.595443",
          "fundingFee": "157.475456",
          "isolatedMargin": "0",
          "cumOpenSize": "0.55061",
          "cumOpenValue": "54642.836110",
          "cumOpenFee": "32.785700",
          "cumCloseSize": "0.54061",
          "cumCloseValue": "53666.138456",
          "cumCloseFee": "32.199683",
          "cumFundingFee": "163.232384",
          "cumLiquidateFee": "0",
          "createdMatchSequenceId": "3647905144",
          "updatedMatchSequenceId": "3656434385",
          "createdTime": "1746673529125",
          "updatedTime": "1747188961302",
          "autoAppendIsolatedMargin": false
        }
      ]
    },
    "time": 1747188961302
  }
}