跳至主要内容

持倉

訂閱持倉數據的推送

覆蓋範圍: USDT永續，反向合約

Topic: user.position.contractAccount

響應參數​

參數類型說明
topicstringTopic名
dataarrayObject
> symbolstring合約名稱
> riskIdinteger風險限額ID
> riskLimitValuestring風險限額
> sidestring方向. Buy,Sell
> sizestring持倉大小
> entryPricestring平均入場價
> positionValuestring倉位價值
> positionIdxinteger倉位標識, 用於辨別不同持倉模式
  • 0: 單向持倉模式
  • 1: 買側雙向持倉模式
  • 2: 賣側雙向持倉模式
> tradeModeinteger交易模式. 0: 全倉, 1: 逐倉
> autoAddMargininteger是否自動增加保證金. 0: 否, 1: 是
> leveragestring槓桿倍數
> positionBalancestring倉位保證金
> markPricestring標記價格
> liqPricestring強平價格. 當強平價 <= minPrice 或者強平價 >= maxPrice時, 則為""
> bustPricestring破產價格
> tpSlModestring該字段已廢棄, 無意義, 總是返回"Full"
> takeProfitstring止盈價格
> stopLossstring止損價格
> trailingStopstring追蹤止損
> activePricestring追蹤止損的激活價格
> unrealisedPnlstring未結盈虧
> cumRealisedPnlstring累計盈虧
> occClosingFeestring預佔用平倉手續費
> sessionAvgPricestring結算價格
> positionStatusstring倉位狀態. Normal, Abnormal
> positionMMstring倉位初始保證金
> positionIMstring倉位維持保證金
> adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
> isReduceOnlyboolean僅當Bybit需要降低某個Symbol的風險限額時有用
  • true: 僅允許減倉操作. 您可以考慮一系列的方式, 比如, 降低risk limit檔位, 或者同檔位修改槓桿或減少倉位, 或者增加保證金, 或者撤單, 這些操作做完後, 可以主動調用確認新的風險限額接口
  • false(默認): 沒有交易限制, 表示您的倉位在系統調整時處於風險水平之下
  • 僅對逐倉和全倉的期貨倉位有意義
> mmrSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
  • 當isReduceOnly=true: 這個時間戳表示系統強制修改MMR的時間
    • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了MMR調整的時間
  • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
  • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
  • 僅對逐倉和全倉的期貨倉位有意義
> leverageSysUpdatedTimestring僅當Bybit需要降低某個Symbol的風險限額時有用
  • 當isReduceOnly=true: 這個時間戳表示系統強制修改槓桿的時間
    • 當isReduceOnly=false: 若不為空, 則表示系統已經完成了槓桿調整的時間
  • 僅當系統調整才會賦值, 對於主動的調整, 不會在這裡展示時間戳
  • 默認為"", 但如果曾經這個symbol有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
  • 僅對逐倉和全倉的期貨倉位有意義
> createdTimestring倉位創建時間戳 (毫秒)
> updatedTimestring倉位創建時間戳 (毫秒)

推送示例​

{
    "topic": "user.position.contractAccount",
    "data": [
        {
            "positionIdx": 0,
            "riskId": 1,
            "symbol": "ARBUSDT",
            "side": "None",
            "size": "0",
            "positionValue": "0",
            "entryPrice": "0",
            "tradeMode": 0,
            "autoAddMargin": 0,
            "leverage": "10",
            "positionBalance": "0",
            "liqPrice": "",
            "bustPrice": "0.0000",
            "takeProfit": "0.0000",
            "stopLoss": "0.0000",
            "trailingStop": "0.0000",
            "unrealisedPnl": "0",
            "createdTime": "1695115891722",
            "updatedTime": "1697686565866",
            "tpSlMode": "Full",
            "sessionAvgPrice": "0.0000",
            "positionStatus": "Normal",
            "occClosingFee": "0",
            "markPrice": "0.7747",
            "cumRealisedPnl": "21.84890946",
            "activePrice": "0.0000",
            "riskLimitValue": "200000",
            "positionMM": "0",
            "positionIM": "0",
            "adlRankIndicator": 0,
            "isReduceOnly": false,
            "mmrSysUpdateTime": "",
            "leverageSysUpdatedTime": ""
        }
    ]
}