持倉

訂閱 position.event 主題，實時接收 Event Contract 倉位更新推送。

Topic： position.event

信息

• 訂閱私有主題前需先完成身份驗證。
• 以下情況會觸發推送：新建 Event Contract 倉位（訂單成交）、倉位金額變動（部分成交）、倉位結算（cumClosedPnl 更新）。

返回參數

參數	類型	說明
id	string	消息 ID
topic	string	Topic 名稱
creationTime	number	數據創建時間戳（毫秒）
data	array	對象
> symbol	string	交易對名稱
> baseCoin	string	標的幣種
> settleCoin	string	結算幣種
> side	string	倉位方向：Buy（做多）、Sell（做空）
> ecContractType	string	事件合約類型：UpDown、Target、Range
> ecDirection	string	方向：UP/DOWN（UpDown 類型），ABOVE/BELOW（Target 類型），RANGE_IN/RANGE_OUT（Range 類型）
> avgPayoutRatio	string	平均賠付比率
> positionValue	string	倉位價值（累計成交金額）
> ecSettleTime	string	預計結算時間（毫秒）
> cumClosedPnl	string	累計已結算盈虧
> createdTime	string	倉位創建時間（毫秒）
> updatedTime	string	倉位更新時間（毫秒）
> seq	long	跨業務序號，用於排序

訂閱示例

{
    "op": "subscribe",
    "args": [
        "position.event"
    ]
}

推送示例

{
    "id": "592324d2bce751-ad38-48eb-8f42-4671d1fb4d4e",
    "topic": "position.event",
    "creationTime": 1694515703798,
    "data": [
        {
            "symbol": "ETHUSDT-28AUG26-2450-2570-OUT",
            "baseCoin": "BTC",
            "settleCoin": "USDT",
            "side": "Buy",
            "ecContractType": "UpDown",
            "ecDirection": "UP",
            "avgPayoutRatio": "1.85",
            "positionValue": "100",
            "ecSettleTime": "1694515498753",
            "cumClosedPnl": "50.5",
            "createdTime": "1694402559843",
            "updatedTime": "1694515498753",
            "seq": 31413030
        }
    ]
}