Get Closed Orders - KUCOIN API

Description

This interface is to obtain all Spot Closed order lists, and the return value of the active order interface is the paged data of all uncompleted order lists. The returned data is sorted in descending order according to the latest update time of the order.

After the user successfully places an order, the order is in Active state, and the user can use inOrderBook to determine whether the order has entered the order. Canceled or fully filled orders are marked as completed Done status.

Tips

If the order is not an active order, you can only get data within the time range of 7 * 24 hours (ie: 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

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 an 'limit' order or 'market' order.

Allowed values:

limitmarket

lastId

integer <int64>

optional

The id of the last set of data from the previous batch of data. 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.

> 0

Example:

254062248624417

limit

integer

optional

Default20，Max100

>= 1<= 100

Default:

Example:

startAt

integer <int64>

optional

Start time (milisecond)

> 1000000000000< 9999999999999

Example:

1728663338000

endAt

integer <int64>

optional

End time (milisecond)

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

> 0

items

array [object {34}]

required

Example

{
  "code": "200000",
  "data": {
    "lastId": 19814995255305,
    "items": [
      {
        "id": "6717422bd51c29000775ea03",
        "clientOid": "5c52e11203aa677f33e493fb",
        "symbol": "BTC-USDT",
        "opType": "DEAL",
        "type": "limit",
        "side": "buy",
        "price": "70000",
        "size": "0.00001",
        "funds": "0.7",
        "dealSize": "0.00001",
        "dealFunds": "0.677176",
        "remainSize": "0",
        "remainFunds": "0.022824",
        "cancelledSize": "0",
        "cancelledFunds": "0",
        "fee": "0.000677176",
        "feeCurrency": "USDT",
        "stp": null,
        "timeInForce": "GTC",
        "postOnly": false,
        "hidden": false,
        "iceberg": false,
        "visibleSize": "0",
        "cancelAfter": 0,
        "channel": "API",
        "remark": "order remarks",
        "tags": null,
        "cancelExist": false,
        "tradeType": "TRADE",
        "inOrderBook": false,
        "active": false,
        "tax": "0",
        "createdAt": 1729577515444,
        "lastUpdatedAt": 1729577515481
      }
    ]
  }
}