Get Trade History

Description

Get a list of recent fills. If you need to get your recent trade history with low latency, please query endpoint Get List of Orders Completed in 24h. The requested data is not real-time.

Data Time Range

The system allows you to retrieve up to one week’s worth of data (starting from the last day by default). If the time period of the queried data exceeds one week (time range from start time to end time exceeding 24 * 7 hours), the system will prompt to remind you that you have exceeded the time limit. If you only specified the start time, the system will automatically calculate the end time (end time = start time + 24 hours). Conversely, if you only specified the end time, the system will calculate the start time (start time = end time - 24 hours) the same way.

Fee

Orders on KuCoin Futures platform are classified into two types, taker and maker. A taker order matches other resting orders on the exchange order book, and gets executed immediately after order entry. A maker order, on the other hand, stays on the exchange order book and awaits to be matched. Taker orders will be charged taker fees, while maker orders will receive maker rebates. Please note that market orders, iceberg orders and hidden orders are always charged taker fees.

The system will pre-freeze a predicted taker fee when you place an order. The liquidity field indicates if the fill was charged taker or maker fees.

The system will pre-freeze the predicted fees (including the maintenance margin needed for the position, entry fees and fees to close positions) if you added the position, and will not pre-freeze fees if you reduced the position. After the order is executed, if you added positions, the system will deduct entry fees from your balance; if you closed positions, the system will deduct the close fees.

Request

Query Params

orderId

string

optional

List fills for a specific order only (if you specify orderId, other parameters can be ignored)

Example:

236655147005071361

symbol

string

optional

Symbol of the contract. Please refer to Get Symbol endpoint: symbol

side

enum<string>

optional

Order side

Allowed values:

buysell

type

enum<string>

optional

Order Type

Allowed values:

limitmarketlimit_stopmarket_stop

tradeTypes

string

optional

Transaction type: trade, adl, liquid, settlement. Supports querying multiple types at the same time, separated by commas. Query all types when empty

Examples:

tradeadlliquidsettlementadl,liquid

startAt

integer <int64>

optional

Start time (milliseconds)

endAt

integer <int64>

optional

End time (milliseconds)

currentPage

integer

optional

Current request page. The default currentPage is 1

Default:

pageSize

integer

optional

pageSize, The default pageSize is 50; the maximum cannot exceed 1000

<= 1000

Default:

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

currentPage

integer

required

pageSize

integer

required

totalNum

integer

required

totalPage

integer

required

items

array [object {26}]

required

Example

{
  "code": "200000",
  "data": {
    "currentPage": 1,
    "pageSize": 50,
    "totalNum": 2,
    "totalPage": 1,
    "items": [
      {
        "symbol": "XBTUSDTM",
        "tradeId": "1828954878212",
        "orderId": "284486580251463680",
        "side": "buy",
        "liquidity": "taker",
        "forceTaker": false,
        "price": "86275.1",
        "size": 1,
        "value": "86.2751",
        "openFeePay": "0.05176506",
        "closeFeePay": "0",
        "stop": "",
        "feeRate": "0.00060",
        "fixFee": "0",
        "feeCurrency": "USDT",
        "subTradeType": null,
        "marginMode": "CROSS",
        "openFeeTaxPay": "0",
        "closeFeeTaxPay": "0",
        "displayType": "market",
        "fee": "0.05176506",
        "settleCurrency": "USDT",
        "orderType": "market",
        "tradeType": "trade",
        "tradeTime": 1740640088244000000,
        "createdAt": 1740640088427
      }
    ]
  }
}

Request

Request samples

Responses