- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- Rate Limit
- Change Log
- User Service
- Unified REST
- Unified Websocket
- 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
- Orders
- Add OrderPOST
- Add Order SyncPOST
- Add Order TestPOST
- Batch Add OrdersPOST
- Batch Add Orders SyncPOST
- Cancel Order By OrderIdDELETE
- Cancel Order By OrderId SyncDELETE
- Cancel Order By ClientOidDELETE
- Cancel Order By ClientOid SyncDELETE
- Cancel Partial OrderDELETE
- Cancel All Orders By SymbolDELETE
- Cancel All OrdersDELETE
- Modify OrderPOST
- Get Order By OrderIdGET
- Get Order By ClientOidGET
- Get Symbols With Open OrderGET
- Get Open OrdersGET
- Get Open Orders By PageGET
- Get Closed OrdersGET
- Get Trade HistoryGET
- Get DCPGET
- Set DCPPOST
- Add Stop OrderPOST
- Cancel Stop Order By ClientOidDELETE
- Cancel Stop Order By OrderIdDELETE
- Batch Cancel Stop OrdersDELETE
- Get Stop Orders ListGET
- Get Stop Order By OrderIdGET
- Get Stop Order By ClientOidGET
- Add OCO OrderPOST
- Cancel OCO Order By OrderIdDELETE
- Cancel OCO Order By ClientOidDELETE
- Batch Cancel OCO OrderDELETE
- Get OCO Order By OrderIdGET
- Get OCO Order By ClientOidGET
- Get OCO Order Detail By OrderIdGET
- Get OCO Order ListGET
- 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
- 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
- Earn
- VIP Lending
- Affiliate
- Broker
- Convert
- Classic Websocket
- Error Code
- Abandoned Endpoints
- Introduction
- Account & Funding
- Get sub-account List - Summary Info (V1)
- Get sub-account List - Spot Balance (V1)
- Get Deposit Addresses (V2)
- Get Deposit Addresses - 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
- Add Deposit Address - V1
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Affiliate
- Broker
- Developing
Get Trade History
GET
https://api.kucoin.com/api/v1/hf/fills
api-channel:Private
api-permission:General
api-rate-limit-pool:Spot
sdk-service:Spot
sdk-sub-service:Order
sdk-method-name:getTradeHistory
api-rate-limit-weight:2
Description
The returned data is sorted in descending order according to the latest update time of the order.
Tips
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/v1/hf/fills?symbol=BTC-USDT&orderId&side&type&lastId=254062248624417&limit=100&startAt=1728663338000&endAt=1728692138000'Responses
🟢200OK
application/json
Body
Example
{
"code": "200000",
"data": {
"items": [
{
"id": 19814995255305,
"orderId": "6717422bd51c29000775ea03",
"counterOrderId": "67174228135f9e000709da8c",
"tradeId": 11029373945659392,
"symbol": "BTC-USDT",
"side": "buy",
"liquidity": "taker",
"type": "limit",
"forceTaker": false,
"price": "67717.6",
"size": "0.00001",
"funds": "0.677176",
"fee": "0.000677176",
"feeRate": "0.001",
"feeCurrency": "USDT",
"stop": "",
"tradeType": "TRADE",
"taxRate": "0",
"tax": "0",
"createdAt": 1729577515473
}
],
"lastId": 19814995255305
}
}Modified at 2025-11-18 10:40:24