取得訂單歷史記錄

GET

https://api.kucoin.com/api/ua/v2/unified/order/history

api-channel:Private

api-permission:General

api-rate-limit-pool:Management

api-rate-limit-weight:4

sdk-service:UTA

sdk-method-name:getOrderHistory

sdk-sub-service:Order

Description

此介面可用於取得訂單歷史記錄

Tips

歷史訂單查詢限制：

訂單類型	可查詢時間範圍
無成交的已取消 `NORMAL` 訂單	最近 2 小時內
已觸發或已取消的 `ADVANCED` 訂單	最近 2 小時內
有成交的 `NORMAL` 訂單	最近 168 小時內

備註
若指定的查詢時間範圍超過允許的視窗，系統將預設查詢對應的最大時間視窗內的資料。

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
    "code": "200000",
    "data": {
        "tradeType": "SPOT",
        "lastId": 5716,
        "items": [
            {
                "orderId": "385529378341146624",
                "symbol": "BTC-USDT",
                "orderType": "LIMIT",
                "side": "BUY",
                "size": "0.0000216",
                "price": "93000",
                "timeInForce": "GTC",
                "tags": "",
                "orderTime": 1764730568586000020,
                "stp": "",
                "cancelAfter": null,
                "postOnly": false,
                "reduceOnly": false,
                "triggerDirection": "",
                "triggerPrice": "",
                "triggerPriceType": "",
                "tpTriggerPrice": "",
                "tpTriggerPriceType": "",
                "slTriggerPrice": "",
                "slTriggerPriceType": "",
                "status": "3",
                "filledSize": "0.0000216",
                "avgPrice": "92792.8",
                "fee": "0.00200432448",
                "feeCurrency": "USDT",
                "tax": "",
                "updatedTime": 1764730568593000000,
                "triggerOrderId": "",
                "cancelReason": "",
                "cancelSize": "0",
                "clientOid": "test_limit_209384512054",
                "sizeUnit": "BASECCY",
                "brokerTag": "KuCoinPartner"
            }
        ]
    }
}

Request

Query Params

Responses

🟢200OK

application/json

Body

Modified at 2026-09-14 10:32:38

取得開放訂單列表

取得交易歷史記錄