高頻交易已完成訂單列表

該接口是獲取已成交高頻訂單列表，返回值是分頁後的數據。返回數據都根據訂單最新更新時間降序排序。 用戶成功下單後，訂單就處於活躍（Active）狀態，用戶可以通過 inOrderBook 來判斷委託是否進入買賣盤。被取消或者已完全成交的訂單則被標記爲已完成（Done）狀態。

查詢“已完成”狀態的訂單時，您只能獲取 3 * 24 小時時間範圍內的數據（即：從當前時間起至3 * 24 小時前）。若超出時間範圍，系統會默認查詢 3 * 24 小時時間範圍內的數據。

HTTP請求

GET /api/v1/hf/orders/done

請求示例

GET /api/v1/hf/orders/done?symbol=BTC-ETH&type=limit&side=buy

// response
{
   "code":"200000",
   "data":{
      "lastId":2682265600,
      "items":[
         {
            "id":"63074a5a27ecbe0001e1f3ba",
            "symbol":"CSP-USDT",
            "opType":"DEAL",
            "type":"limit",
            "side":"sell",
            "price":"0.1",
            "size":"0.1",
            "funds":"0.01",
            "dealSize":"0",
            "dealFunds":"0",
            "fee":"0",
            "feeCurrency":"USDT",
            "stp":"",
            "timeInForce":"GTC",
            "postOnly":false,
            "hidden":false,
            "iceberg":false,
            "visibleSize":"0",
            "cancelAfter":0,
            "channel":"API",
            "clientOid":"",
            "remark":"",
            "tags":"",
            "cancelExist":true,
            "createdAt":1661422170924,
            "lastUpdatedAt":1661422196926,
            "tradeType":"TRADE",
            "inOrderBook":false,
            "active":false,
            "cancelledSize": "0",
            "cancelledFunds": "0",
            "remainSize": "0",
            "remainFunds": "0"
         }
      ]
   }
}

API權限

此接口需要通用權限

請求URL

此接口支持現貨URL

頻率限制

現貨類權重：2

請求參數

請求參數	類型	是否必須	含義
symbol	String	是	只返回指定交易對的訂單信息
side	String	否	buy（買）或 sell（賣）
type	String	否	訂單類型: limit（限價單）, market(市價單)
startAt	long	否	開始時間（毫秒），限制訂單最新更新(完成)時間
endAt	long	否	截止時間（毫秒），限制訂單最新更新(完成)時間
lastId	long	否	前一批次數據最後一條數據的id，默認獲取最新數據
limit	int	否	默認20，最大100

TIP

lastId用來過濾數據和分頁，如果不輸入lastId，默認返回最多100條最新數據，返回結果中有lastId，使用它作爲查詢條件，可以查詢下一頁次新數據

返回值

字段	含義
id	訂單id，訂單唯一標識
symbol	交易對
opType	操作類型: DEAL
type	訂單類型
side	買或賣
price	訂單價格
size	訂單數量
cancelledSize	累計取消數量
dealSize	成交數量
remainSize	剩餘數量
funds	下單金額
cancelledFunds	市價單累計取消資金
dealFunds	成交額
remainFunds	市價單剩餘資金
fee	手續費
feeCurrency	計手續費幣種
stp	自成交保護
timeInForce	訂單時效策略
postOnly	是否爲被動委託
hidden	是否爲隱藏單
iceberg	是否爲冰山單
visibleSize	冰山單在買賣盤可見數量
cancelAfter	timeInForce 爲 GTT n秒後過期
channel	下單來源
clientOid	客戶端生成的標識
remark	訂單說明
tags	訂單標籤
active	訂單狀態 true: 訂單狀態爲 active; false: 訂單訂單狀態爲 done
inOrderBook	是否進入買賣盤 true: 進入買賣盤; false: 沒有進入買賣盤
cancelExist	訂單是否存在取消記錄
createdAt	訂單創建時間
lastUpdatedAt	訂單最新更新時間
tradeType	交易類型: TRADE（現貨交易）