查詢歷史訂單

提示

獲取歷史訂單紀錄. 由於訂單創建/撤銷是異步的, 該接口返回數據可能會有延遲. 若您想實時獲取訂單信息, 您可以查詢該接口或者通過websocket推送(推薦)

HTTP 請求

GET /unified/v3/private/order/list

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. linear, option
symbol	false	string	合約名稱
baseCoin	false	string	交易幣種. 若category=option，不傳時，默認返回BTC相關數據
orderId	false	string	訂單Id
orderLinkId	false	string	用戶自定義訂單Id
orderStatus	false	string	訂單狀態。不傳則默認查詢所有狀態
orderFilter	false	string	Order: 普通單, StopOrder: 條件單
direction	false	string	翻頁方向. prev: 向前, next: 向後. 默認: next
limit	false	integer	每頁數量限制. [1, 50]. 默認: 20
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
category	string	產品類型
nextPageCursor	string	游標，用於翻頁
list	array	Object
> orderId	string	訂單Id
> orderLinkId	string	用戶自定義Id
> blockTradeId	string	Paradigm大宗交易Id
> symbol	string	合約名稱
> iv	string	隱含波動率. linear沒有該字段
> price	string	訂單價格
> qty	string	訂單數量
> side	string	方向. Buy,Sell
> orderStatus	string	訂單狀態
> orderType	string	訂單類型. Market,Limit
> stopOrderType	string	條件單類型. option沒有該字段
> rejectReason	string	被拒絕原因
> cumExecValue	string	訂單累計成交價值
> cumExecFee	string	訂單累計成交的手續費
> cumExecQty	string	訂單累計成交數量
> tpTriggerBy	string	觸發止盈的價格類型. option沒有該字段
> slTriggerBy	string	Stop loss price. option沒有該字段
> timeInForce	string	執行策略
> basePrice	string	當前市價，用於條件單
> triggerBy	string	觸發價格的觸發類型. option沒有該字段
> triggerPrice	string	觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格. option沒有該字段
> leavesQty	string	訂單剩餘未成交的數量
> leavesValue	string	訂單剩餘未成交的價值. option沒有該字段
> reduceOnly	boolean	只減倉. true表明這是只減倉單
> closeOnTrigger	boolean	觸發後平倉委託. option沒有該字段
> takeProfit	string	止盈價格. option沒有該字段
> stopLoss	string	止損價格. option沒有該字段
> orderIM	string	訂單初始保證金. 組合保證金模式下，該字段返回空字符串
> createdTime	number	創建訂單的時間戳 (毫秒)
> updatedTime	number	訂單更新的時間戳 (毫秒)

請求示例

GET /unified/v3/private/order/list?category=linear&orderFilter=StopOrder&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672811957817
X-BAPI-RECV-WINDOW: 5000
cdn-request-id: test-002

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "nextPageCursor": "c6f055d9-7f21-4079-913d-e6523a9cfffa%3A1672216686849%2Cc6f055d9-7f21-4079-913d-e6523a9cfffa%3A1672216686849",
        "category": "linear",
        "list": [
            {
                "symbol": "ETHPERP",
                "orderType": "Limit",
                "orderLinkId": "linear-004",
                "orderId": "c6f055d9-7f21-4079-913d-e6523a9cfffa",
                "stopOrderType": "Stop",
                "orderStatus": "Deactivated",
                "takeProfit": "",
                "cumExecValue": "0",
                "blockTradeId": "",
                "rejectReason": "EC_NoError",
                "price": "1050",
                "createdTime": 1672216686849,
                "tpTriggerBy": "UNKNOWN",
                "timeInForce": "GoodTillCancel",
                "basePrice": "1188",
                "leavesValue": "0",
                "updatedTime": 1672217377166,
                "side": "Sell",
                "triggerPrice": "1145.00000000",
                "cumExecFee": "0",
                "slTriggerBy": "UNKNOWN",
                "leavesQty": "0",
                "closeOnTrigger": false,
                "cumExecQty": "0",
                "reduceOnly": false,
                "qty": "0.15",
                "stopLoss": "",
                "triggerBy": "MarkPrice",
                "orderIM": ""
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672811958171
}