跳至主要内容

查詢持倉 (實時)

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

統一帳戶覆蓋範圍: USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權
經典帳戶覆蓋範圍: USDT永續 / 反向合約

信息

關於反向合約的額外查詢規則,

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

HTTP 請求

GET /v5/position/list

請求參數

參數是否必需類型說明
categorytruestring產品類型
  • 統一帳戶: linear,inverse, option
  • 經典帳戶: linear, inverse
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:空头.
  • 經典帳戶的單向模式下和統一帳戶的反向合約: 空倉時返回None.
  • 統一帳戶(正向合約): 單向或對沖模式空的仓位返回空字符串
> sizestring當前倉位的合约數量
> avgPricestring當前倉位的平均入場價格
  • 對於8小時結算的USDC合約倉位, 該字段表示的是平均開倉價格, 不隨著結算而改變
  • > positionValuestring仓位的價值
    > tradeModeinteger交易模式。
    • 統一帳戶 (反向合約) & 經典帳戶: 0: 全倉, 1: 逐倉
    • 統一帳戶: 廢棄, 總是 0
    > autoAddMargininteger是否自動追加保證金. 0: 否, 1: 是. 僅當統一帳戶(除反向合約)開啟了帳戶維度的逐倉保證金模式, 該字段才有意義
    > positionStatusString倉位状态. Normal,Liq, Adl
    > leveragestring當前倉位的槓桿,仅适用于合约. 注意:若賬戶為組合保證金模式(PM),該字段返回空字符串,槓桿規則失效
    > markPricestringsymbol 的最新標記價格
    > liqPricestring倉位強平價格,
    • UTA(反向合約) & 普通账户 & UTA(開啟逐倉保證金模式):是逐倉和全倉持仓的真實價格, 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    • 統一帳戶(全倉保證金):是全倉持仓的预估价格(因为统一帳戶模式是按照帳戶維度控制风险率), 當強平價 <= minPrice或者 強平價 >= maxPrice, 則為""
    但是對於組合保證金模式,此字段為空,不會提供強平價格
    > bustPricestring倉位破產價格. 統一保證金模式返回"", 無倉位破產價格 (不包括統一帳戶下的反向交易)
    > positionIMstring倉位起始保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > positionMMstring倉位維持保證金. 組合保證金模式(PM)下, 該字段返回為空字符串
    > tpslModestring該字段廢棄, 無意義, 總是返回"Full". 期權總是返回""
    > positionBalancestring倉位保證金
  • 統一帳戶(linear): 僅在逐倉保證金模式下有意義
  • > takeProfitstring止盈價格
    > stopLossstring止損價格
    > trailingStopstring追蹤止損(與當前價格的距離)
    > sessionAvgPricestringUSDC合約平均持倉價格, 會隨著8小時結算而變動
    > deltastringDelta, 期權的獨有字段
    > gammastringGamma, 期權的獨有字段
    > vegastringVega, 期權的獨有字段
    > thetastringTheta, 期權的獨有字段
    > unrealisedPnlstring未结盈亏
    > curRealisedPnlstring當前持倉的已結盈虧
    > cumRealisedPnlstring累计已结盈亏
    • 期貨: 是從第一次開始有持倉加總的已結盈虧
    • 期權: 總是"", 無意義
    > 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倉位數據更新時間
    > seqlong序列號, 用於關聯成交和倉位的更新
    • 不同的幣對會存在相同seq, 可以使用seq + symbol來做唯一性識別
    • 如果該幣對從未被交易過, 查詢時則會返回"-1"
    • 對於更新槓桿、更新風險限額等非交易行為, 將會返回上一次成交時更新的seq
    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
    }