查詢升級前訂單紀錄
支持查詢升級到統一帳戶之前發生的USDT永續, USDC永續, 反向合約, 現貨和期權
統一帳戶2.0:
通過category=linear, 查詢到在經典帳戶期間產生的USDT永續, USDC永續數據
通過category=spot, 查詢到在經典帳戶期間產生的現貨數據
通過category=option, 查詢到在經典帳戶期間產生的期權數據
通過category=inverse, 查詢到在經典帳戶或者統一帳戶1.0期間產生的反向合約數據統一帳戶1.0:
通過category=linear, 查詢到在經典帳戶期間產生的USDT永續, USDC永續數據
通過category=spot, 查詢到在經典帳戶期間產生的現貨數據
通過category=option, 查詢到在經典帳戶期間產生的期權數據
信息
- 7天內, 可以查詢到全狀態的紀錄
- 7天外, 僅能查詢到已成交的紀錄
- USDC永續和期權僅支持查詢最近6個月的數據, 對於更老的數據, 請前往網頁端下載
HTTP 請求
GET /v5/pre-upgrade/order/history
請求參數
| 參數 | 是否必需 | 類型 | 說明 |
|---|---|---|---|
| category | true | string | 產品類型. linear, inverse, option, spot |
| symbol | false | string | 合約名稱.
|
| baseCoin | false | string | 交易幣種. 期權的預留字段 |
| orderId | false | string | 訂單ID |
| orderLinkId | false | string | 用戶自定義訂單ID |
| orderFilter | false | string | Order: 普通單, StopOrder: 條件單 |
| orderStatus | false | string | 訂單狀態. 不支持現貨 |
| startTime | false | integer | 開始時間戳 (毫秒)
|
| endTime | false | integer | 結束時間戳 (毫秒) |
| limit | false | integer | 每頁數量限制. [1, 50]. 默認: 20 |
| cursor | false | string | 游標，用於翻頁 |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| category | string | 產品類型 |
| list | array | Object |
| > orderId | string | 訂單Id |
| > orderLinkId | string | 用戶自定義Id |
| > blockTradeId | string | 大宗交易訂單Id |
| > symbol | string | 合約名稱 |
| > price | string | 訂單價格 |
| > qty | string | 訂單數量 |
| > side | string | 方向. Buy,Sell |
| > isLeverage | string | 該字段對升級前的帳戶訂單無意義 |
| > positionIdx | integer | 倉位標識。用戶不同倉位模式 |
| > orderStatus | string | 訂單狀態 |
| > cancelType | string | 訂單被取消類型 |
| > rejectReason | string | 拒絕原因 |
| > avgPrice | string | 訂單平均成交價格. 若沒有成交，則返回"", 以及部分成交但最終被手動取消的訂單 |
| > leavesQty | string | 訂單剩餘未成交的數量 |
| > leavesValue | string | 訂單剩餘未成交的價值 |
| > cumExecQty | string | 訂單累計成交數量 |
| > cumExecValue | string | 訂單累計成交價值 |
| > cumExecFee | string | 訂單累計成交的手續費 |
| > timeInForce | string | 執行策略 |
| > orderType | string | 訂單類型. Market,Limit |
| > stopOrderType | string | 條件單類型 |
| > orderIv | string | 隱含波動率 |
| > triggerPrice | string | 觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格 |
| > takeProfit | string | 止盈價格 |
| > stopLoss | string | 止損價格 |
| > tpTriggerBy | string | 觸發止盈的價格類型 |
| > slTriggerBy | string | 觸發止損的價格類型 |
| > triggerDirection | integer | 觸發方向. 1: 上漲, 2: 下跌 |
| > triggerBy | string | 觸發價格的觸發類型 |
| > lastPriceOnCreated | string | 下單時的市場價格 |
| > reduceOnly | boolean | 只減倉. true表明這是只減倉單 |
| > closeOnTrigger | boolean | 觸發後平倉委託. 什麼是觸發後平倉委託? |
| > placeType | string | 下單類型, 僅期權使用. iv, price |
| > smpType | string | SMP執行類型 |
| > smpGroup | integer | 所屬Smp組ID. 如果uid不屬於任何組, 則默認為0 |
| > smpOrderId | string | 觸發此SMP執行的交易對手的 orderID |
| > createdTime | string | 創建訂單的時間戳 (毫秒) |
| > updatedTime | string | 訂單更新的時間戳 (毫秒) |
| nextPageCursor | string | 游標，用於翻頁 |
Request Example
GET /v5/pre-upgrade/order/history?category=linear&limit=1&orderStatus=Filled HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1682576940304
X-BAPI-RECV-WINDOW: 5000
Response Example
{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"orderId": "67836246-460e-4c52-a009-af0c3e1d12bc",
"orderLinkId": "",
"blockTradeId": "",
"symbol": "BTCUSDT",
"price": "27203.40",
"qty": "0.200",
"side": "Sell",
"isLeverage": "",
"positionIdx": 0,
"orderStatus": "Filled",
"cancelType": "UNKNOWN",
"rejectReason": "EC_NoError",
"avgPrice": "28632.126000",
"leavesQty": "0.000",
"leavesValue": "0",
"cumExecQty": "0.200",
"cumExecValue": "5726.4252",
"cumExecFee": "3.43585512",
"timeInForce": "IOC",
"orderType": "Market",
"stopOrderType": "UNKNOWN",
"orderIv": "",
"triggerPrice": "0.00",
"takeProfit": "0.00",
"stopLoss": "0.00",
"tpTriggerBy": "UNKNOWN",
"slTriggerBy": "UNKNOWN",
"triggerDirection": 0,
"triggerBy": "UNKNOWN",
"lastPriceOnCreated": "0.00",
"reduceOnly": true,
"closeOnTrigger": true,
"smpType": "None",
"smpGroup": 0,
"smpOrderId": "",
"createdTime": "1682487465732",
"updatedTime": "1682487465735",
"placeType": ""
}
],
"nextPageCursor": "page_token%3D69406%26",
"category": "linear"
},
"retExtInfo": {},
"time": 1682576940540
}