歷史訂單

信息

• 如果startTime和endTime都不傳，則默認查詢近7天的數據。
• 單次查詢最長3個月，最長支持查詢最近6個月的歷史數據。
• 市商總是只能查最近3天的數據

HTTP 請求

GET /spot/v3/private/history-orders

請求參數

參數	是否必須	類型	說明
symbol	false	string	幣對名稱
orderId	false	string	通過指定訂單ID返回比這個orderId小的訂單,可以用來分頁
limit	false	integer	返回數量限制. [1, 500]. 默認: 100
startTime	false	integer	起始時間戳（毫秒）
endTime	false	integer	結束時間戳（毫秒）
orderCategory	false	integer	訂單類型. 默認為0：普通訂單; 1：止盈止損訂單，若是止盈止損則必傳

返回參數

參數	類型	說明
accountId	string	賬戶ID
symbol	string	幣對名稱
orderLinkId	string	特殊訂單ID，用戶自己生成
orderId	string	訂單ID
orderPrice	string	訂單價格，對於LIMIT 訂單必需發送
orderQty	string	訂單數量
execQty	string	成交數量
cummulativeQuoteQty	string	對於某些歷史數據 cummulativeQuoteQty 可能會 < 0, 這說明數據當前不可用。
avgPrice	string	訂單已成交的平均價格
status	string	訂單狀態
timeInForce	string	執行策略
orderType	string	訂單類型, LIMIT/MARKET/LIMIT_MAKER
side	string	買賣方向. BUY：買入, SELL：賣出
stopPrice	string	停止價
icebergQty	string	請忽略
createTime	number	撮合引擎中的創建時間
updateTime	number	訂單上次更新的時間戳
isWorking	string	是否生效. 0：未生效, 1：已生效
orderCategory	integer	訂單種類. 0：普通單; 1：止盈止損單. 止盈止損單有這個字段
triggerPrice	string	觸發價格. 止盈止損單有這個字段
blockTradeId	string	Paradigm大宗交易ID
cancelType	string	Cancel type. CancelBySmp
smpType	string	SMP執行類型
smpGroup	integer	所屬Smp組ID. 如果uid不屬於任何組, 則默認為0
smpOrderId	string	觸發此SMP執行的交易對手的 orderID

請求示例

Console

curl --location --request GET 'https://api-testnet.bybit.com/spot/v3/private/history-orders?symbol=BTCUSDT&limit=2&startTime=1658246400000&endTime=1659110400000' \
--header 'X-BAPI-SIGN: XXXXX' \
--header 'X-BAPI-API-KEY: {api key}' \
--header 'X-BAPI-TIMESTAMP: 1659082629976' \
--header 'X-BAPI-RECV-WINDOW: 5000'

響應示例

Normal order

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "accountId": "533287",
                "symbol": "BTCUSDT",
                "orderLinkId": "spotx003",
                "orderId": "1210856408331857664",
                "orderPrice": "23800",
                "orderQty": "0.02",
                "execQty": "0",
                "cummulativeQuoteQty": "0",
                "avgPrice": "0",
                "status": "REJECTED",
                "timeInForce": "GTC",
                "orderType": "LIMIT_MAKER",
                "side": "BUY",
                "stopPrice": "0.0",
                "icebergQty": "0.0",
                "createTime": 1659081332185,
                "updateTime": 1659081332225,
                "isWorking": "1",
                "blockTradeId": "1",
                "cancelType": "UNKNOWN"
                "smpGroup": 0,
                "smpOrderId": "",
                "smpType": "None"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1659082630638
}

Stop order

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "accountId": "533287",
                "symbol": "BTCUSDT",
                "orderLinkId": "testSpot_21",
                "orderId": "1261593545444244992",
                "orderPrice": "20000",
                "orderQty": "0.1",
                "status": "ORDER_CANCELED",
                "timeInForce": "GTC",
                "orderType": "LIMIT",
                "side": "BUY",
                "stopPrice": "0.0",
                "icebergQty": "0.0",
                "createTime": 1665129670254,
                "updateTime": 1665130043196,
                "isWorking": "1",
                "executedOrderId": "1261593545444244993",
                "triggerPrice": "22000",
                "orderCategory": 1
            }
        ]
    },
    "retExtInfo": {},
    "time": 1665131956061
}