Get Trade History - KUCOIN API

Description

This endpoint can be used to obtain a list of the latest Margin transaction details.
The returned data is sorted in descending order according to the latest update time of the order.

Tips

If the order is not an active order, you can only get data within the time range of 7 * 24 hours (i.e.: from the current time to 7 * 24 hours ago). If the time range is exceeded, the system will query the data within the time range of 7 * 24 hours by default.

Request

Query Params

symbol

string

required

symbol

Example:

BTC-USDT

tradeType

enum<string>

required

Trade type: MARGIN_TRADE - cross margin trade, MARGIN_ISOLATED_TRADE - isolated margin trade

Allowed values:

MARGIN_TRADEMARGIN_ISOLATED_TRADE

Example:

MARGIN_TRADE

orderId

string

optional

The unique order id generated by the trading system
(If orderId is specified, please ignore the other query parameters)

side

enum<string>

optional

Specify if the order is to 'buy' or 'sell'.

Allowed values:

buysell

type

enum<string>

optional

Specify if the order is a 'limit' order or 'market' order.

Allowed values:

limitmarket

lastId

integer <int64>

optional

The ID of the last set of data from the previous data batch. By default, the latest information is given.
lastId is used to filter data and paginate. If lastId is not entered, the default is a maximum of 100 returned data items. The return results include lastId, which can be used as a query parameter to look up new data from the next page.

Example:

254062248624417

limit

integer

optional

Default20, Max100

>= 1<= 100

Default:

Example:

100

startAt

integer <int64>

optional

Start time (milliseconds)

Example:

1728663338000

endAt

integer <int64>

optional

End time (milliseconds)

Example:

1728692138000

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

lastId

integer <int64>

required

items

array [object {20}]

required

Example

{
  "code": "200000",
  "data": {
    "items": [
      {
        "id": 137891621991,
        "symbol": "BTC-USDT",
        "tradeId": 11040911994273792,
        "orderId": "671868085584bc0007d85f46",
        "counterOrderId": "67186805b7cbdf00071621f9",
        "side": "buy",
        "liquidity": "taker",
        "forceTaker": false,
        "price": "67141.6",
        "size": "0.00001",
        "funds": "0.671416",
        "fee": "0.000671416",
        "feeRate": "0.001",
        "feeCurrency": "USDT",
        "stop": "",
        "tradeType": "MARGIN_TRADE",
        "tax": "0",
        "taxRate": "0",
        "type": "limit",
        "createdAt": 1729652744998
      }
    ],
    "lastId": 137891621991
  }
}