- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- OpenClaw
- Rate Limit Rule (UTA)
- Rate Limit Rule (Classic)
- Change Log
- User Service
- UTA REST V2
- Introduction
- Market Data
- Get Announcements
- Get Currency
- Get Currencies
- Get Ticker
- Get Symbol
- Get Klines
- Get OrderBook
- Get Index Price
- Get Trades
- Get Position Tiers
- Get Collateral Ratio
- Get Borrowable Currencies
- Get Current Funding Rate
- Get History Funding Rate
- Get Futures Open Interest
- Get Interest Rate Index
- Get Max Order Quantity
- Platform 24h Market Statistics
- Get Call Auction Info
- Get Fiat Price
- Get Third-Party Custody Currencies
- Get Service Status
- Get KYC Regions
- Get Client IP Address
- Account Info
- Account & Funding
- Get Account Overview (UTA)
- Get Account Currency Assets (UTA)
- Get Account Currency Assets (Classic)
- Get Apikey Info
- Get Account Mode
- Set Account Mode
- Get Leverage (UTA)
- Modify Futures Leverage (UTA)
- Modify Cross Margin Leverage (UTA)
- Get Borrowing Rates and Limits
- Get Account Ledger
- Get Interest History (UTA)
- Get API Rate Limit
- Get All API Rate Limit
- Get API Rate Limit Cap
- Get Fee Rate
- KCS Fee Deduction Management
- Get Third-Party Custody Account Currency Limits
- Sub Account
- Deposit
- Transfer
- Withdraw
- Account & Funding
- Orders
- Positions
- VIP Lending
- UTA WebSocket V2
- Classic REST
- Account Info
- Account & Funding
- Get Account Summary Info
- Get Apikey Info
- Get Account Type - Spot
- Get Account List - Spot
- Get Account Detail - Spot
- Get Account - Cross Margin
- Get Account - Isolated Margin
- Get Account - Futures
- Get Account Ledgers - Spot/Margin
- Get Account Ledgers - Trade_hf
- Get Account Ledgers - Margin_hf
- Get Account Ledgers - Futures
- Sub Account
- Sub Account API
- Deposit
- Withdrawals
- Transfer
- Trade Fee
- Account & Funding
- Spot Trading
- Market Data
- Get Announcements
- Get Currency
- Get All Currencies
- Get Symbol
- Get All Symbols
- Get Ticker
- Get All Tickers
- Get Trade History
- Get Klines
- Get Part OrderBook
- Get Full OrderBook
- Get Call Auction Part OrderBook
- Get Call Auction Info
- Get Fiat Price
- Get 24hr Stats
- Get Market List
- Get Client IP Address
- Get Server Time
- Get Service Status
- Get KYC Regions
- Orders
- Add Order
- Add Order Sync
- Add Order Test
- Batch Add Orders
- Batch Add Orders Sync
- Cancel Order By OrderId
- Cancel Order By OrderId Sync
- Cancel Order By ClientOid
- Cancel Order By ClientOid Sync
- Cancel Partial Order
- Cancel All Orders By Symbol
- Cancel All Orders
- Modify Order
- Get Order By OrderId
- Get Order By ClientOid
- Get Symbols With Open Order
- Get Open Orders
- Get Open Orders By Page
- Get Closed Orders
- Get Trade History
- Get DCP
- Set DCP
- Add Stop Order
- Cancel Stop Order By ClientOid
- Cancel Stop Order By OrderId
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Market Data
- Margin Trading
- Market Data
- Orders
- Add Order
- Add Order Test
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Cancel All Orders By Symbol
- Get Symbols With Open Order
- Get Open Orders
- Get Closed Orders
- Get Trade History
- Get Order By OrderId
- Get Order By ClientOid
- Add Stop Order
- Cancel Stop Order By OrderId
- Cancel Stop Order By ClientOid
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Debit
- Credit
- Risk Limit
- Futures Trading
- Introduction
- Market Data
- Orders
- Add Order
- Add Order Test
- Batch Add Orders
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Batch Cancel Orders
- Cancel All Orders
- Cancel All Stop orders
- Get Order By OrderId
- Get Order By ClientOid
- Get Order List
- Get Recent Closed Orders
- Get Stop Order List
- Get Open Order Value
- Get Recent Trade History
- Get Trade History
- Positions
- Get Margin Mode
- Switch Margin Mode
- Batch Switch Margin Mode
- Get Position Mode
- Switch Position Mode
- Get Max Open Size
- Get Position Details
- Get Position List
- Get Positions History
- Get Max Withdraw Margin
- Get Cross Margin Leverage
- Modify Cross Margin Leverage
- Add Isolated Margin
- Remove Isolated Margin
- Get Cross Margin Risk Limit
- Get Cross Margin Requirement
- Get Isolated Margin Risk Limit
- Modify Isolated Margin Risk Limit
- Funding Fees
- Earn
- VIP Lending
- Affiliate
- Broker
- Introduction
- Broker Application
- Instructions
- Broker Pro
- Exchange Broker
- Introduction
- Get Broker Rebate
- Get Broker RebateV3
- Submit KYC
- Get KYC Status
- Get KYC Status List
- Get Broker Info
- Add sub-account
- Get sub-account
- Add sub-account API
- Get sub-account API
- Modify sub-account API
- Delete sub-account API
- Transfer
- Get Transfer History
- Get Deposit List
- Get Deposit Detail
- Get Withdraw Detail
- Set Markup Fee
- Get Markup Fee
- Copy Trading
- Introduction
- Add Order
- Add Order Test
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Get Max Open Size
- Get Max Withdraw Margin
- Add Isolated Margin
- Remove Isolated Margin
- Modify Isolated Margin Risk Limit
- Modify Isolated Margin Auto-Deposit Status
- Switch Margin Mode
- Modify Cross Margin Leverage
- Get Cross Margin Requirement
- Switch Position Mode
- Convert
- Account Info
- Classic WebSocket
- Web3 Wallet
- Error Code
- Abandoned Endpoints
- Introduction
- UTA REST
- Introduction
- Market Data
- Get Announcements
- Get Currency
- Get Currencies
- Get Symbol
- Get Ticker
- Get OrderBook
- Get Klines
- Get Trades
- Get Collateral Ratio
- Get Index Price
- Get Current Funding Rate
- Get History Funding Rate
- Get Position Tiers
- Get Futures Open Interest
- Get Service Status
- Get Third-Party Custody Currencies
- Get Borrowable Currencies
- Get KYC Regions
- Get Client IP Address
- Get Fiat Price
- Get Interest Rate Index
- Platform 24h Market Statistics
- Get max order quantity
- Get Call Auction Info
- Account
- Get Account Overview (UTA)
- Get Account Currency Assets (UTA)
- Get Account Currency Assets (Classic)
- Get Sub Account Currency Assets
- Get Transfer Quotas
- Flex Transfer
- Set Sub Account Transfer Permission
- Get Account Mode
- Set Account Mode
- Get Fee Rate
- Get Account Ledger
- Get Interest History (UTA)
- Modify Futures Leverage (UTA)
- Get Third-Party Custody Account Currency Limits
- Modify Cross Margin Leverage (UTA)
- Get Leverage (UTA)
- Get Borrowing Rates and Limits
- Get Apikey Info
- Add sub-account
- Get Sub-account List
- Get sub-account API List
- Add sub-account API
- Modify sub-account API
- Delete sub-account API
- Get Deposit Address
- Get Deposit History
- Get Withdrawal Quotas
- Withdraw
- Cancel Withdrawal
- Get Withdrawal History
- KCS Fee Deduction Management
- Get API Rate Limit Cap
- Set Sub Accounts API Rate Limit
- Get API Rate Limit
- Get All API Rate Limit
- Orders
- Positions
- VIP Lending
- UTA WebSocket
- PRO REST
- Classic
- Account & Funding
- Get Deposit Addresses (V2)
- Get Deposit Addresses - V1
- Add Deposit Address - V1
- Get sub-account List - Summary Info (V1)
- Get sub-account List - Spot Balance (V1)
- Sub-account Transfer
- Get Deposit History - Old
- Internal Transfer
- Get Futures Account Transfer Out Ledger
- Get Withdrawal History - Old
- Futures Account Transfer Out
- Futures Account Transfer In
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Affiliate
- Broker
- Account & Funding
- Developing
Get Order History
GET
https://api.kucoin.com/api/ua/v2/unified/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
Tips
| Order Type | Queryable Time Range |
|---|---|
Canceled NORMAL orders without fills | Within the last 2 hours |
Triggered or canceled ADVANCED orders | Within the last 2 hours |
NORMAL Orders with fills | Within the last 168 hours |
Note
If the specified time range exceeds the allowed window, the system will query data within the corresponding maximum window by default.
Request
Query Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request 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'Responses
🟢200OK
application/json
Body
Example
{
"code": "200000",
"data": {
"tradeType": "FUTURES",
"lastId": 130610708,
"items": [
{
"orderId": "402666817186754560",
"symbol": "XBTUSDTM",
"orderType": "LIMIT",
"side": "BUY",
"size": "10",
"price": "30",
"timeInForce": "GTC",
"tags": "",
"orderTime": 1768816452405840836,
"stp": "",
"cancelAfter": null,
"postOnly": false,
"reduceOnly": false,
"triggerDirection": "",
"triggerPrice": "",
"triggerPriceType": "",
"tpTriggerPrice": "",
"tpTriggerPriceType": "",
"slTriggerPrice": "",
"slTriggerPriceType": "",
"filledSize": "0",
"avgPrice": "0",
"fee": "0",
"feeCurrency": "USDT",
"tax": "0",
"updatedTime": 1768816452408000000,
"triggerOrderId": "",
"cancelReason": "You have canceled the order.",
"cancelSize": "10",
"clientOid": "",
"sizeUnit": "UNIT",
"status": 5
}
]
}
}Modified at 2026-08-27 07:52:25