跳至主要内容

查詢持倉 (實時)

該接口可以獲取用戶的持倉信息，比如持倉數量，累計盈虧等

HTTP 請求​

GET /contract/v3/private/position/list

請求參數​

參數是否必需類型說明
symbolfalsestring合約名稱
settleCoinfalsestring結算幣種. 查詢期貨時, symbol 和 settleCoin二者必傳一個. symbol優先級更高

響應參數​

參數類型說明
categorystring產品類型
nextPageCursorstring游標，用於翻頁
listarrayObject
> symbolstring合約名称
> sidestring方向. Buy, Sell. 單倉模式下，無倉位則返回None
> sizestring當前倉位的數量，按照合約張數計算
> entryPricestring平均入場價
> leveragestring槓桿倍數
> positionValuestring仓位的價值
> positionIdxinteger倉位標識符, 用于在不同仓位模式下标识仓位
> riskIdinteger风险限额ID. 參見風險限額接口
> riskLimitValuestring當前風險限額ID對應的持倉限制量
> tradeModeinteger0: 全倉模式. 1: 逐倉模式
> autoAddMargininteger0: 否. 1: 是. 僅適用於逐倉模式
> positionBalancestring倉位保證金
> liqPricestring預估強平價. 當強平價 <= minPrice 或者強平價 >= maxPrice時, 則為""
> bustPricestring預估破產價
> tpSlModestring該字段已廢棄, 無意義, 總是返回"Full"
> takeProfitstring止盈價格
> stopLossstring止損價格
> trailingStopstring追蹤止損（與當前價格的距離）
> activePricestring追蹤止損的激活價格
> markPricestring實時標記價格
> unrealisedPnlstring未结盈亏
> cumRealisedPnlstring累计已结盈亏
> positionMMstring倉位維持保證金
> positionIMstring倉位起始保證金
> positionStatusstring倉位狀態
> sessionAvgPricestring結算價格
> occClosingFeestring預佔用平倉手續費
> 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倉位數據更新時間 (毫秒)

請求示例​

GET /contract/v3/private/position/list?symbol=ETCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1673421074950
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "positionIdx": 0,
                "riskId": 236,
                "symbol": "ETCUSDT",
                "side": "None",
                "size": "0.0",
                "positionValue": "0",
                "entryPrice": "0",
                "tradeMode": 0,
                "autoAddMargin": 0,
                "leverage": "10",
                "positionBalance": "0",
                "liqPrice": "",
                "bustPrice": "0.000",
                "takeProfit": "0.000",
                "stopLoss": "0.000",
                "trailingStop": "0.000",
                "unrealisedPnl": "0",
                "createdTime": "1672986751942",
                "updatedTime": "1675382400091",
                "tpSlMode": "Full",
                "riskLimitValue": "200000",
                "activePrice": "0.000",
                "markPrice": "15.126",
                "cumRealisedPnl": "-10.69094915",
                "positionMM": "0",
                "positionIM": "0",
                "positionStatus": "Normal",
                "sessionAvgPrice": "0.000",
                "occClosingFee": "0",
                "avgPrice": "0",
                "adlRankIndicator": 0,
                "isReduceOnly": false,
                "mmrSysUpdatedTime": "",
                "leverageSysUpdatedTime": ""
            }
        ],
        "category": "",
        "nextPageCursor": ""
    },
    "retExtInfo": {},
    "time": 1697685149803
}