跳至主要内容

查詢升級前成交紀錄

目前,僅支持查詢升級到統一帳戶之前發生的USDT永續, USDC永續, 反向合約和期權, 返回結果按execTime降序排列

提示
  • 儅execTime相同時,返回會有排序問題,此問題已在優化中, 目前建議依照execId+OrderId+leavesQty進行排序, 如果您想獲取實時成交信息建議使用websocket stream.
  • 單筆訂單可能會有多次成交.
  • 您可以通過指定symbol, baseCoin, orderId 和 orderLinkId字段來查詢。如果您使用多字段組合,系統的查詢優先級如下: orderId > orderLinkId > symbol > baseCoin.

HTTP 請求

GET v5/pre-upgrade/execution/list

請求參數

參數是否必需類型說明
categorytruestring產品類型 linear, inverse, option
symbolfalsestring合約名稱
orderIdfalsestring訂單ID
orderLinkIdfalsestring用戶自定義訂單ID
baseCoinfalsestring交易幣種. 僅期權使用
startTimefalseinteger開始時間戳 (毫秒)
  • startTime 和 endTime都不傳入, 則默認返回最近7天的數據
  • startTime 和 endTime都傳入的話, 則確保endTime - startTime <= 7天
  • 若只傳startTime,則查詢startTime和startTime+7天的數據
  • 若只傳endTime,則查詢endTime-7天和endTime的數據
endTimefalseinteger結束時間戳 (毫秒)
execTypefalsestring執行類型
limitfalseinteger每頁數量限制. [1, 100]. 默認: 50
cursorfalsestring游標,用於翻頁

響應參數

參數類型說明
categorystring產品類型
listarrayObject
> symbolstring合約名稱
> orderIdstring訂單Id
> orderLinkIdstring用戶自定義訂單id
> sidestring訂單方向.買: Buy,賣:Sell
> orderPricestring訂單價格
> orderQtystring訂單數量
> leavesQtystring剩餘委託未成交數量
> orderTypestring訂單類型. 市價單:Market,限價單:Limit
> stopOrderTypestring条件单的订单类型。如果该订单不是条件单,则不会返回任何类型
> execFeestring交易手續費
> execIdstring成交Id
> execPricestring成交價格
> execQtystring成交數量
> execTypestring交易類型
> execValuestring成交價值
> execTimestring成交時間(毫秒)
> isMakerBool是否是 Maker 訂單,true 為 maker 訂單,false 為 taker 訂單
> feeRatestring手續費率
> tradeIvstring隱含波動率,僅期權有效
> markIvstring標記價格的隱含波動率,僅期權有效
> markPricestring成交執行時,該 symbol 當時的標記價格
> indexPricestring成交執行時,該 symbol 當時的指數價格,目前僅對期權業務有效
> underlyingPricestring成交執行時,該 symbol 當時的底層資產價格,僅期權有效
> blockTradeIdstring大宗交易的订单 ID ,使用 paradigm 进行大宗交易时生成的 ID
> closedSizestring平倉數量
nextPageCursorstring游標,用於翻頁

Request Example

GET /v5/pre-upgrade/execution/list?category=linear&limit=1&execType=Funding&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1682580752432
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"symbol": "BTCUSDT",
"orderId": "1682553600-BTCUSDT-592334-Sell",
"orderLinkId": "",
"side": "Sell",
"orderPrice": "0.00",
"orderQty": "0.000",
"leavesQty": "0.000",
"orderType": "UNKNOWN",
"stopOrderType": "UNKNOWN",
"execFee": "0.6364003",
"execId": "11f1c4ed-ff20-4d73-acb7-96e43a917f25",
"execPrice": "28399.90",
"execQty": "0.011",
"execType": "Funding",
"execValue": "312.3989",
"execTime": "1682553600000",
"isMaker": false,
"feeRate": "0.00203714",
"tradeIv": "",
"markIv": "",
"markPrice": "28399.90",
"indexPrice": "",
"underlyingPrice": "",
"blockTradeId": "",
"closedSize": "0.000"
}
],
"nextPageCursor": "page_token%3D96184191%26",
"category": "linear"
},
"retExtInfo": {},
"time": 1682580752717
}