獲取成交記錄

此接口，可獲取最近的成交明細列表 返回值是分頁後的數據，根據時間降序排序。

HTTP請求

GET /api/v1/fills

請求示例

GET /api/v1/fills

{
    "currentPage":1,
    "pageSize":1,
    "totalNum":251915,
    "totalPage":251915,
    "items":[
        {
            "symbol":"BTC-USDT",
            "tradeId":"5c35c02709e4f67d5266954e",
            "orderId":"5c35c02703aa673ceec2a168",
            "counterOrderId":"5c1ab46003aa676e487fa8e3",
            "side":"buy",
            "liquidity":"taker",
            "forceTaker":true,
            "price":"0.083",
            "size":"0.8424304",
            "funds":"0.0699217232",
            "fee":"0",
            "feeRate":"0",
            "feeCurrency":"USDT",
            "stop":"",
            "type":"limit",
            "createdAt":1547026472000,
            "tradeType": "TRADE"
        }
    ]
}

API權限

此接口需要通用權限

請求URL

此接口支持現貨URL

頻率限制

現貨類權重：10

TIP

這個接口需要使用分頁

請求參數

請求參數	類型	是否必須	含義
orderId	String	否	查詢該訂單Id 的成交明細（如果指定了orderId，請忽略其他查詢條件）
symbol	String	否	查詢指定交易對的成交明細
side	String	否	buy（買） 或 sell（賣）
type	String	否	訂單類型: limit（限價單）, market(市價單), limit_stop(限價止盈止損單), market_stop（市價止盈止損單）
startAt	long	否	開始時間（毫秒）
endAt	long	否	截止時間（毫秒）
tradeType	String	是	交易類型: TRADE（現貨交易）, MARGIN_TRADE(槓桿交易), MARGIN_ISOLATED_TRADE(逐倉槓桿), 默認為TRADE.

返回值

字段	含義
symbol	交易對
tradeId	交易Id
orderId	訂單Id
counterOrderId	對手方訂單Id
side	買或賣
forceTaker	是否強制作爲taker處理
liquidity	流動性類型: taker 或 maker
price	訂單價格
size	訂單數量
funds	成交額
fee	手續費
feeRate	手續費率
feeCurrency	計手續費幣種
stop	止盈止損類型，entry:止盈; loss:止損
type	訂單類型limit 或 market
createdAt	創建時間
tradeType	交易類型: TRADE（現貨交易）, MARGIN_TRADE(槓桿交易)

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

TIP

檢索的總條目不能超過5萬條，如果超過，請縮短查詢時間範圍。

結算 結算分爲兩部分:

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

手續費

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