跳至主要内容

查詢升級前平倉盈虧

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

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
}