跳至主要内容

查詢持倉 (實時)

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

信息

統一帳戶2.0 - 查詢反向合約倉位

  1. 通過這種查詢方式 "/v5/position/list?category=inverse", 可以獲得所有持倉數據
  2. 不支持傳入多個symbol來查詢 關於反向合約的額外查詢規則,

統一帳戶1.0 和 經典帳戶 - 查詢反向合約倉位

  1. 通過這樣子查詢"/v5/position/list?category=inverse", 您可以查詢到所有當前持有的反向合約倉位;
  2. symbol字段支持傳入最多10個反向合約, 比如 symbol=BTCUSD,ETHUSD,SOLUSD

HTTP 請求

GET /v5/position/list

請求參數

參數是否必需類型說明
categorytruestring產品類型
symbolfalsestring合約名稱
  • 若傳了symbol, 則不管是否有倉位都返回該symbol數據
  • symbol不傳但傳了settleCoin, 則僅返回有實際倉位的數據
baseCoinfalsestring交易幣種, 若不傳, 則返回期權下所有持倉
僅適用於option
settleCoinfalsestring結算幣種
  • USDT和USDC期貨: symbolsettleCon必傳其中一個, 若都傳,則symbol有更高的優先級
  • limitfalseinteger每頁數量限制. [1, 200]. 默認: 20
    cursorfalsestring游標,用於翻頁

    響應參數

    參數類型說明
    categorystring產品類型
    listarrayObject
    > positionIdxinteger倉位標識符, 用于在不同仓位模式下标识仓位
    > riskIdinteger风险限额ID, 參見風險限額接口
    若賬戶為組合保證金模式(PM), 該字段返回0, 風險限額規則失效
    > riskLimitValuestring當前風險限額ID對應的持倉限制量
    若賬戶為組合保證金模式(PM),該字段返回"", 風險限額規則失效
    > symbolstring合約名称
    > sidestring持倉方向, Buy: 多头; Sell: 空头.
    • 單向持倉: 經典帳戶 & 統一帳戶1.0(inverse), 空倉返回None.
    • 統一帳戶2.0和統一帳戶1.0(linear): 空倉時, 單向或者雙向持倉模式都返回空字符串 ""
    > sizestring當前倉位的合约數量, 總是正數
    > avgPricestring當前倉位的平均入場價格
  • 對於8小時結算的USDC合約倉位, 該字段表示的是平均開倉價格, 不隨著結算而改變
  • > positionValuestring仓位的價值
    > tradeModeinteger交易模式
    > autoAddMargininteger是否自動追加保證金, 反向合約不支持設置自動追加保證金
  • 0: 否
  • 1: 是
  • > positionStatusString倉位状态. Normal,Liq, Adl
    > leveragestring當前倉位的槓桿,仅适用于合约
    若賬戶為組合保證金模式(PM), 該字段返回空字符串, 槓桿規則失效
    > markPricestringsymbol 的最新標記價格
    > liqPricestring倉位強平價格
    • 對於統一帳戶2.0(逐倉), 統一帳戶1.0(逐倉), 統一帳戶1.0(反向合約), 經典帳戶:
      是逐倉和全倉持仓的真實價格, 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    • 對於統一帳戶2.0(全倉保證金), 統一帳戶1.0(全倉保證金):
      是全倉持仓的预估价格(因为统一帳戶模式是按照帳戶維度控制风险率), 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    對於組合保證金模式, 此字段為空, 不會提供強平價格
    > bustPricestring倉位破產價格
    > positionIMstring倉位起始保證金
  • 經典帳戶 & 統一帳戶1.0(inverse): 忽略該字段
  • 統一帳戶組合保證金模式(PM)下, 該字段返回為空字符串
  • > positionMMstring倉位維持保證金
  • 經典帳戶 & 統一帳戶1.0(inverse): 忽略該字段
  • 統一帳戶組合保證金模式(PM)下, 該字段返回為空字符串
  • > positionBalancestring倉位保證金
    經典帳戶 & 統一帳戶1.0(inverse)可以根據這個字段了解倉位初始保證金+平倉手續費
    > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損(與當前價格的距離)
    > sessionAvgPricestringUSDC合約平均持倉價格, 會隨著8小時結算而變動
    > deltastringDelta
    > gammastringGamma
    > vegastringVega
    > thetastringTheta
    > unrealisedPnlstring未结盈亏
    > curRealisedPnlstring當前持倉的已結盈虧
    > cumRealisedPnlstring累计已结盈亏
    • 期貨: 是從第一次開始有持倉加總的已結盈虧
    • 期權: 總是"", 無意義
    > adlRankIndicatorinteger自動減倉燈. 什麼是自動減倉機制?
    > createdTimestring倉位創建時間
    > updatedTimestring倉位數據更新時間
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
    • 如果該幣對從未被交易過, 查詢時則會返回"-1"
    • 對於更新槓桿、更新風險限額等非交易行為, 將會返回上一次成交時更新的seq
    > 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有過系統降檔的操作, 那麼這裡會顯示上一次操作的時間
    • 僅對逐倉和全倉的期貨倉位有意義
    > tpslModestring該字段廢棄, 無意義, 總是返回"Full". 期權總是返回""
    nextPageCursorstring游標,用於翻頁

    請求示例

    GET /v5/position/list?category=linear&symbol=XRPUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672280218882
    X-BAPI-RECV-WINDOW: 5000

    響應示例

    {
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "list": [
    {
    "positionIdx": 0,
    "riskId": 1,
    "riskLimitValue": "150",
    "symbol": "BTCUSD",
    "side": "Sell",
    "size": "300",
    "avgPrice": "27464.50441675",
    "positionValue": "0.01092319",
    "tradeMode": 0,
    "positionStatus": "Normal",
    "autoAddMargin": 1,
    "adlRankIndicator": 2,
    "leverage": "10",
    "positionBalance": "0.00139186",
    "markPrice": "28224.50",
    "liqPrice": "",
    "bustPrice": "999999.00",
    "positionMM": "0.0000015",
    "positionIM": "0.00010923",
    "tpslMode": "Full",
    "takeProfit": "0.00",
    "stopLoss": "0.00",
    "trailingStop": "0.00",
    "unrealisedPnl": "-0.00029413",
    "sessionAvgPrice": "",
    "curRealisedPnl": "0.00013123",
    "cumRealisedPnl": "-0.00096902",
    "seq": 5723621632,
    "isReduceOnly": false,
    "mmrSysUpdateTime": "",
    "leverageSysUpdatedTime": "",
    "createdTime": "1676538056258",
    "updatedTime": "1697673600012"
    }
    ],
    "nextPageCursor": "",
    "category": "inverse"
    },
    "retExtInfo": {},
    "time": 1697684980172
    }