查詢歷史訂單

提示

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

HTTP 請求

GET /contract/v3/private/order/list

請求參數

參數	是否必需	類型	說明
symbol	false	string	合約名稱
orderId	false	string	訂單ID
orderLinkId	false	string	用戶自定義訂單ID
orderStatus	false	string	訂單狀態。不傳則默認查詢所有狀態
orderFilter	false	string	Order,StopOrder
limit	false	integer	每頁數量限制. [1, 50]. 默認: 20
cursor	false	string	游標，用於翻頁

響應參數

參數	類型	說明
category	string	產品類型
nextPageCursor	string	游標，用於翻頁
list	list	Object
> symbol	string	Symbol name
> orderId	string	訂單ID
> orderLinkId	string	用戶自定義ID
> side	string	方向. Buy,Sell
> orderType	string	訂單類型. Market,Limit. 對於止盈止損單, 則表示為觸發後的訂單類型
> price	string	訂單價格
> iv	string	隱含波動率
> qty	string	訂單數量
> timeInForce	string	執行策略
> orderStatus	string	訂單狀態
> positionIdx	integer	倉位標識. 0: 單向持倉, 1: 買側雙向持倉, 2: 賣側雙向持倉
> lastPriceOnCreated	string	創建訂單時的市場價
> cancelType	string	取消類型
> rejectReason	string	被拒絕原因
> stopOrderType	string	條件單類型
> triggerDirection	string	1: 上升時觸發, 2: 下降時觸發
> triggerBy	string	觸發價格的觸發類型
> triggerPrice	string	觸發價格. 若stopOrderType=TrailingStop, 則這是激活價格. 否則, 它是觸發價格
> cumExecValue	string	訂單累計成交價值
> cumExecFee	string	訂單累計成交的手續費
> cumExecQty	string	訂單累計成交數量
> leavesValue	string	訂單剩餘未成交的價值
> leavesQty	string	訂單剩餘未成交的數量
> takeProfit	string	止盈價格
> stopLoss	string	止損價格
> tpslMode	string	止盈止損模式 Full: 全部倉位止盈止損, Partial: 部分倉位止盈止損
> tpLimitPrice	string	觸發止盈後轉換為限價單的價格
> slLimitPrice	string	觸發止損後轉換為限價單的價格
> tpTriggerBy	string	觸發止盈的價格類型
> slTriggerBy	string	觸發止損的價格類型
> reduceOnly	boolean	只減倉. true表明這是只減倉單
> closeOnTrigger	boolean	觸發後平倉委託. 什麼是觸發後平倉委託?
> blockTradeId	string	Paradigm 大宗交易ID
> smpType	string	SMP執行類型
> smpGroup	integer	所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
> smpOrderId	string	觸發此SMP執行的交易對手的 orderID
> createdTime	string	訂單創建時間戳 (毫秒)
> updatedTime	string	訂單更新時間戳 (毫秒)

請求示例

GET /contract/v3/private/order/list?symbol=BTCUSDT&orderId=806f5fc6-d487-46d1-9a57-4b4964126c90 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1673420679798
X-BAPI-RECV-WINDOW: 5000
cdn-request-id: test-10

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "symbol": "BTCUSDT",
                "side": "Buy",
                "orderType": "Limit",
                "price": "26864.40",
                "qty": "0.003",
                "reduceOnly": false,
                "timeInForce": "PostOnly",
                "orderStatus": "Cancelled",
                "leavesQty": "0.000",
                "leavesValue": "0",
                "cumExecQty": "0.000",
                "cumExecValue": "0",
                "cumExecFee": "0",
                "lastPriceOnCreated": "0.00",
                "rejectReason": "EC_PerCancelRequest",
                "orderLinkId": "YLxaWKMiHU",
                "createdTime": "1684810640078",
                "updatedTime": "1684810770380",
                "orderId": "806f5fc6-d487-46d1-9a57-4b4964126c90",
                "stopOrderType": "UNKNOWN",
                "takeProfit": "0.00",
                "stopLoss": "0.00",
                "tpTriggerBy": "UNKNOWN",
                "slTriggerBy": "UNKNOWN",
                "triggerPrice": "0.00",
                "closeOnTrigger": false,
                "triggerDirection": 0,
                "positionIdx": 1,
                "cancelType": "CancelByUser",
                "iv": "",
                "triggerBy": "UNKNOWN",
                "blockTradeId": "",
                "tpslMode": "Full",
                "tpLimitPrice": "",
                "slLimitPrice": "",
                "smpType": "None",
                "smpGroup": 0,
                "smpOrderId": ""
            }
        ],
        "nextPageCursor": "eyJza2lwX2xvY2FsX3N5bWJvbCI6ZmFsc2UsInBhZ2VfdG9rZW4iOiIzOTQ3NCJ9",
        "category": ""
    },
    "retExtInfo": {},
    "time": 1684810802126
}