跳至主要内容

查詢升級前平倉盈虧

支持查詢升級到統一帳戶之前發生的USDT永續 / 反向合約, 返回結果按照updatedTime降序排列

  • 統一帳戶2.0:
    通過category=linear, 查詢到在經典帳戶期間產生的USDT永續數據
    通過category=inverse, 查詢到在經典帳戶或者統一帳戶1.0期間產生的反向合約數據

  • 統一帳戶1.0:
    通過category=linear, 查詢到在經典帳戶期間產生的USDT永續數據

HTTP 請求

GET /v5/pre-upgrade/position/closed-pnl

請求參數

參數是否必需類型說明
categorytruestring產品類型
  • linear, inverse
  • symboltruestring合約名稱
    startTimefalseinteger開始時間戳 (毫秒)
    • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
    • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
    • 若只傳startTime,則查詢startTime和startTime+7天的數據
    • 若只傳endTime,則查詢endTime-7天和endTime的數據
    endTimefalseinteger結束時間戳 (毫秒)
    limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
    cursorfalsestring游標,用於翻頁

    響應參數

    參數類型說明
    categorystring產品類型
    listarrayObject
    > symbolstring合約名稱
    > orderIdstring訂單Id
    > sidestring買賣方向 Buy, Side
    > qtystring訂單數量
    > orderPricestring訂單價格
    > orderTypestring訂單類型. Market,Limit
    > execTypestring執行類型. Trade, BustTrade, SessionSettlePnL, Settle
    > closedSizestring平倉數量
    > cumEntryValuestring被平倉位的累計入場價值
    > avgEntryPricestring平均入場價格
    > cumExitValuestring被平倉位的累計出場價值
    > avgExitPricestring平均出場價格
    > closedPnlstring被平倉位的盈虧
    > fillCountstring成交筆數
    > leveragestring持倉槓桿
    > createdTimestring創建時間 (毫秒)
    > updatedTimestring更新時間 (毫秒)
    nextPageCursorstring游標,用於翻頁

    請求示例

    GET /v5/pre-upgrade/position/closed-pnl?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXX
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1682580911998
    X-BAPI-RECV-WINDOW: 5000

    響應示例

    {
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "list": [
    {
    "symbol": "BTCUSDT",
    "orderId": "67836246-460e-4c52-a009-af0c3e1d12bc",
    "side": "Sell",
    "qty": "0.200",
    "orderPrice": "27203.40",
    "orderType": "Market",
    "execType": "Trade",
    "closedSize": "0.200",
    "cumEntryValue": "5588.88",
    "avgEntryPrice": "27944.40",
    "cumExitValue": "5726.4252",
    "avgExitPrice": "28632.13",
    "closedPnl": "204.25510011",
    "fillCount": "22",
    "leverage": "10",
    "createdTime": "1682487465732",
    "updatedTime": "1682487465732"
    }
    ],
    "category": "linear",
    "nextPageCursor": ""
    },
    "retExtInfo": {},
    "time": 1682580912259
    }