獲取成交記錄

  {
    "code": "200000",
    "data": {
      "currentPage":1,
      "pageSize":1,
      "totalNum":251915,
      "totalPage":251915,
      "items":[
          {
            "symbol": "XBTUSDM",  //合約編號
            "tradeId": "5ce24c1f0c19fc3c58edc47c",  //交易編號
            "orderId": "5ce24c16b210233c36ee321d",  //訂單編號
            "side": "sell",  //買賣方向
            "liquidity": "taker",  //流動性類型 taker or maker
            "forceTaker": true, //是否強製作爲taker處理
            "price": "8302",  //成交價格
            "size": 10,  //成交數量
            "value": "0.001204529",  //成交價值
            "feeRate": "0.0005",  //費率
            "fixFee": "0.00000006",  //固定費用
            "feeCurrency": "XBT",  //收費幣種
            "stop": "",  //止損單類型標記
            "fee": "0.0000012022",  //交易費用
            "orderType": "limit",  //訂單類型
            "tradeType": "trade",  //交易類型: trade, liquidation, ADL or settlement
            "createdAt": 1558334496000,  //創建時間
            "settleCurrency": "XBT", //結算幣種
			"openFeePay": "0.002",
			"closeFeePay": "0.002",
            "tradeTime": 1558334496000000000, //交易時間納秒
			"marginMode": "ISOLATED" // 新增保证金模式:ISOLATED-逐倉,CROSS-全倉
          }
      ]
    }
}

您可通過此接口獲取最近成交的訂單列表。 如果需要低延時獲取自己的最近成交歷史記錄, 請使用24小時成交列表接口。 此接口返回的歷史成交可能存在一定的延遲。

HTTP請求

GET /api/v1/fills

示例

GET /api/v1/fills

API權限

此接口需要通用權限

請求URL

此接口支持合約URL

頻率限制

合约类权重：5

參數

參數	數據類型	是否必須	含義
orderId	String	否	如果指定了訂單號，會忽略其他參數。
symbol	String	否	合約symbol
side	String	否	buy or sell
type	String	否	limit, market, limit_stop or market_stop
startAt	long	否	開始時間（毫秒）
endAt	long	否	截止時間（毫秒）
currentPage	long	否	頁數，不傳默認1
pageSize	long	否	頁碼，不傳默認50，最大不能超過1000

返回值

參數	含義
symbol	合約編號
tradeId	交易編號
orderId	訂單編號
side	買賣方向
liquidity	流動性類型 taker or maker
forceTaker	是否強製作爲taker處理
price	成交價格
size	成交數量
value	成交價值
feeRate	費率
fixFee	固定費用(廢棄字段，沒有實際使用價值)
feeCurrency	收費幣種
stop	止損單類型標記
fee	交易費用
orderType	訂單類型
tradeType	交易類型: trade, liquidation, ADL or settlement
createdAt	創建時間
settleCurrency	結算幣種
tradeTime	交易時間納秒
openFeePay	開倉交易手續費
closeFeePay	平倉交易手續費
marginMode	保证金模式:ISOLATED-逐倉,CROSS-全倉

數據時間範圍

您可檢索一週時間範圍內的數據您範圍內檢索數據（默認從最近一天開始算起）。 若檢索時間範圍超過一週，系統將提示您超過時間限制。如果查詢只提供開始時間沒有提供結束時間，系統將自動計算結束時間（結束時間=開始時間+ 24小時），反之亦然。

手續費

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

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

加倉訂單需要預凍費用，減倉訂單不凍結任何費用。加倉訂單凍結的費用包括倉位保證金、開倉交易費和平倉交易費。訂單撮合成功後, 如果加倉會扣除加倉交易費, 如果是平倉會扣取平倉交易費。