Get Order History

GET

https://api.kucoin.com/api/ua/v1/{accountMode}/order/history

api-channel:Private

api-permission:General

api-rate-limit-pool:Management

sdk-service:UTA

sdk-sub-service:Order

sdk-method-name:GetOrderHistory

api-rate-limit-weight:4

Description

This interface can be used for getting order history

Tips

Historical orders can only be queried within a limited time window by status.

Account Mode	Trade Type	Order Status	Max Query Range
Classic Account	SPOT	Canceled	2 days (from now back to *2 24 hours**)
Classic Account	SPOT	Filled	7 days (from now back to *7 24 hours**)
Classic Account	FUTURES	Canceled / Filled	Last 3 months; per request: 7 days (from now back to *7 24 hours**)

Note
If the specified time range exceeds the allowed window, the system will query data within the corresponding maximum window by default.

Request

Path Params

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.kucoin.com/api/ua/v1/classic/order/history?tradeType=SPOT&symbol=&side=BUY&orderFilter=NORMAL&startAt=1758092129514&endAt=1758092129580&lastId=123456789&pageSize=50'

Responses

🟢200OK

application/json

Body

Examples

ClassicUnified

{
    "code": "200000",
    "data": {
        "lastId": 137487153727492,
        "tradeType": "SPOT",
        "items": [
            {
                "orderId": "6964d6461aa08b0007067e24",
                "clientOid": "test20938451234982234374024",
                "status": 3,
                "filledSize": "0.001",
                "avgPrice": "90488.1",
                "fee": "0.0904881",
                "tax": "0",
                "tradeId": "20408356621008896",
                "symbol": "BTC-USDT",
                "feeCurrency": "USDT",
                "side": "BUY",
                "orderType": "MARKET",
                "size": "0.001",
                "sizeUnit": "BASECCY",
                "price": "0",
                "timeInForce": "GTC",
                "cancelSize": "0",
                "cancelAfter": 0,
                "postOnly": false,
                "orderTime": 1768216134314000000,
                "updatedTime": 1768216134343000000
            }
        ]
    }
}

Modified at 2026-02-27 03:11:46

Get Open Order List

Get Trade History