跳至主要内容

查詢持倉 (實時)

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

HTTP 請求​

GET /unified/v3/private/position/list

請求參數​

參數是否必需類型說明
categorytruestring產品類型. linear, option
symbolfalsestring合約名稱
baseCoinfalsestring交易幣種.
  • 僅category=option時有效, 若不傳，則僅返回BTC持倉
settleCoinfalsestring結算幣種
directionfalsestring翻頁方向. prev: 向前, next: 向後. 默認: next
limitfalseinteger每頁數量限制. [1, 200]. 默認: 20
cursorfalsestring游標，用於翻頁

響應參數​

參數類型說明
nextPageCursorstring游標，用於翻頁
categorystring產品類型
listarrayObject
> symbolstring合約名稱
> leveragestring槓桿倍數. 注意: 組合保證金模式下，該字段返回""，槓桿規則失效
> updatedTimeinteger倉位數據更新時間戳 (ms)
> sidestring訂單方向. `Buy`, `Sell`
> positionValuestring倉位價值
> takeProfitstring止盈價格
> tpslModestring止盈止損模式. `Partial`, `Full`
> riskIdinteger風險限額ID. 注意: 組合保證金模式下，該字段返回0，風險限額規則失效
> trailingStopstring追蹤止損 (距離當前價格的距離)
> entryPricestring平均入場價
> unrealisedPnlstring未結盈虧
> markPricestring標記價格
> sizestring倉位大小
> stopLossstring止損價格
> cumRealisedPnlstring累計已結盈虧
> positionMMstring倉位維持保證金. 組合保證金模式下，該字段返回""
> createdTimeinteger建立倉位時間戳 (毫秒)
> positionIdxinteger倉位標識, 用于在不同仓位模式下标识仓位
  • `0`: 單向持倉, 統一保證金只有單向持倉
    • > positionIMstring倉位初始保證金. 組合保證金模式下，該字段返回""

    請求示例​

    GET /unified/v3/private/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: 1672820718517
    X-BAPI-RECV-WINDOW: 5000

    響應示例​

    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "nextPageCursor": "updateAt%3D1672819200214",
            "category": "linear",
            "list": [
                {
                    "symbol": "XRPUSDT",
                    "updatedTime": 1672819200214,
                    "leverage": "10",
                    "side": "Buy",
                    "positionValue": "34.91000000",
                    "takeProfit": "",
                    "tpslMode": "Partial",
                    "riskId": 41,
                    "trailingStop": "0",
                    "entryPrice": "0.34910000",
                    "unrealisedPnl": "0.00000000",
                    "markPrice": "0.34910000",
                    "size": "100.0000",
                    "cumRealisedPnl": "-0.02444200",
                    "stopLoss": "",
                    "positionMM": "0.36795140",
                    "createdTime": 1672016298024,
                    "positionIdx": 0,
                    "positionIM": "3.50985140"
                }
            ]
        },
        "retExtInfo": {},
        "time": 1672820720159
    }