高頻交易已完成訂單列表

該接口是獲取已成交高頻訂單列表,返回值是分頁後的數據。返回數據都根據訂單最新更新時間降序排序。 用戶成功下單後,訂單就處於活躍(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(現貨交易)