高頻交易獲取成交記錄

獲取最近的成交明細列表 返回值是分頁後的數據,根據成交(創建)時間降序排序。

HTTP請求

GET /api/v1/hf/fills

請求示例

GET /api/v1/hf/fills?symbol=BTC-USDT

// response
{
   "code":"200000",
   "data":{
      "items":[
         {
            "id":2678765568,
            "symbol":"BTC-ETC",
            "tradeId":616179312641,
            "orderId":"6306cf6e27ecbe0001e1e03a",
            "counterOrderId":"6306cf4027ecbe0001e1df4d",
            "side":"buy",
            "liquidity":"taker",
            "forceTaker":false,
            "price":"1",
            "size":"1",
            "funds":"1",
            "fee":"0.00021",
            "feeRate":"0.00021",
            "feeCurrency":"USDT",
            "stop":"",
            "tradeType":"TRADE",
            "type":"limit",
            "createdAt":1661390702919
         }
      ],
      "lastId":2678765568
   }
}
API權限

此接口需要通用權限

請求URL

此接口支持現貨URL

頻率限制

現貨類權重:2

請求參數
請求參數 類型 是否必須 含義
orderId String 查詢該訂單Id的成交明細(如果指定了orderId,請忽略其他查詢條件)
symbol String 只返回指定交易對的訂單信息
side String buy(買) 或 sell(賣)
type String 訂單類型: limit(限價單), market(市價單)
startAt long 開始時間(毫秒),限制成交記錄成交(創建)時間
endAt long 截止時間(毫秒),限制成交記錄成交(創建)時間
lastId long 前一批次數據最後一條數據的id,默認獲取最新數據
limit int 默認100,最大100

TIP

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

返回值
字段 含義
id 成交明細Id
symbol 交易對
tradeId 交易Id(純數字類型,symbol緯度遞增)
orderId 訂單Id
counterOrderId 對手方訂單Id
side 買或賣
liquidity 流動性類型: taker 或 maker
forceTaker 是否強製作爲taker處理
price 成交價格
size 成交數量
funds 成交額
fee 手續費
feeRate 手續費率
feeCurrency 計手續費幣種
type 訂單類型limit 或 market
stop 止盈止損類型,目前高頻交易還未支持止盈止損類型,所以爲空
createdAt 成交(創建)時間
tradeType 交易類型: TRADE(現貨交易)
查詢時間範圍

您只能獲取 3 * 24 小時時間範圍內的數據(即:從當前時間起至3 * 24 小時前)。若超出時間範圍,系統會默認查詢 3 * 24 小時時間範圍內的數據。

結算

結算分爲兩部分,一部分是成交結算,一部分是費用結算。當撮合完成後,這些數據將立即更新到我們的數據存儲區,系統將啓動結算並從您的預凍結資金中進行扣除。

手續費

KuCoin平台上的訂單分爲兩種類型:Taker 和 Maker。Taker單會與買賣盤上的已有訂單立即成交,而Maker單則相反,會一直留在買賣盤中等待撮合。Taker單消耗了市場的流動性,因此會被收取taker費用,而Maker單增加了市場的流動性,會被收取較低的手續費甚至獲得手續費補貼。請注意:市價單、冰山單和隱藏單都會被扣除taker手續費。

下單時,系統會預凍結您賬戶中的taker費用。流動性(liquidity)字段中的參數說明瞭訂單將會被收取taker還是maker費用。

假設您的訂單是限價單,當您下單後在撮合引擎中被立即撮合,我們將收取您taker費用,而如果您的訂單沒有被立即撮合或有部分剩餘未被撮合都會進入買賣盤,進入買賣盤的訂單在未被取消前成交都會收取您maker手續費。

進入撮合後與對手盤訂單撮合,當指令訂單剩餘金額爲0,交易完成,如果剩餘資金不足以購買最低數量(0.00000001)的商品,則取消指令訂單。

如果您的訂單作爲maker被成交,我們會將剩餘預凍結的taker費用返還給您。

但需要注意的是:

  • 當您創建了一個隱藏委託/冰山委託訂單時,即使它未被撮合引擎立即成交而被被動成交,仍然會收取taker費用
  • 被動委託收取maker費用。如果該委託下單後會立刻與市場已有委託(除冰山/隱藏訂單外)撮合,那麼該委託將被取消。如果被動委託下單後與冰山/隱藏訂單立即成交,被動委託訂單將收取maker費用

舉例:

以BTC/USDT爲例,假設您想市價買入1BTC,手續費率爲0.1%,市場買賣盤數據如下:

Price(USDT) Size(BTC) Side
4200.00 0.18412309 sell
4015.60 0.56849308 sell
4011.32 0.24738383 sell
3995.64 0.84738383 buy
3988.60 0.20484000 buy
3983.85 1.37584908 buy

當您下一個買入市價單時,市場會立即成交,成交明細將分爲3筆,如下圖所示:

Price(USDT) Size(BTC) Fee(BTC)
4011.32 0.24738383 0.00024738
4015.60 0.56849308 0.00056849
4200.00 0.18312409 0.00018312