KUCOIN API - EU
SDK
Telegram
Kucoin
  1. Private Channels
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • Rate Limit
  • Classic REST
    • Account Info
      • Account & Funding
        • Get Account Summary Info
        • Get KYC Regions
        • 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 Ledgers - Spot/Margin
        • Get Account Ledgers - Trade_hf
        • Get Account Ledgers - Margin_hf
      • Sub Account
        • Add sub-account
        • Add sub-account Margin Permission
        • Get sub-account List - Summary Info
        • Get sub-account Detail - Balance
        • Get sub-account List - Spot Balance (V2)
      • Sub Account API
        • Get sub-account API List
        • Add sub-account API
        • Modify sub-account API
        • Delete sub-account API
      • Deposit
        • Add Deposit Address (V3)
        • Get Deposit Address (V3)
        • Get Deposit History
      • Withdrawals
        • Get Withdrawal Quotas
        • Withdraw (V4)
        • Cancel Withdrawal
        • Get Withdrawal History
        • Get Withdrawal History By ID
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Trade Fee
        • Get Basic Fee - Spot/Margin
        • Get Actual Fee - Spot/Margin
    • 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 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
    • Margin Trading
      • Market Data
        • Get Symbols - Cross Margin
        • Get Symbols - Isolated Margin
        • Get Mark Price Detail
        • Get Margin Config
        • Get Mark Price List
        • Get Margin Collateral Ratio
        • Get Market Available Inventory
      • 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
      • Debit
        • Borrow
        • Get Borrow History
        • Repay
        • Get Repay History
        • Get Interest History
        • Modify Leverage
      • Risk Limit
        • Get Margin Risk Limit
    • Earn
      • Simple Earn
        • Purchase
        • Get Redeem Preview
        • Redeem
        • Get Savings Products
        • Get Promotion Products
        • Get Account Holding
    • Broker
      • Introduction
      • Broker Application
      • Instructions
      • Broker Pro
        • Introduction
        • Broker Fast API Service
        • Get Broker Rebate
        • Get Commission
        • Get User List
        • Get User Transactions
  • Classic Websocket
    • Base Info
      • Introduction
      • Get Public Token - Classic Spot/Margin
      • Get Private Token - Classic Spot/Margin
    • Spot Trading
      • Public Channels
        • Ticker
        • All Tickers
        • Orderbook - Level 1
        • Orderbook - Level 5
        • Orderbook - Level 50
        • Orderbook - Increment
        • Call Auction Orderbook - Level 50
        • Call Auction Data
        • Klines
        • Trade
        • Symbol Snapshot
        • Market Snapshot
      • Private Channels
        • Order V2
        • Order V1
        • Balance
        • Stop Order
    • Margin Trading
      • Public Channels
        • Index Price
        • Mark Price
      • Private Channels
        • Cross Margin Position
        • Isolated Margin Position
  • Error Code
    • HTTP
    • Spot
    • Margin
    • Earn
    • Websocket
  • 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
      • Get Deposit History - Old
      • Get Withdrawal History - Old
      • Add Deposit Address - V1
      • Withdraw - V1
    • Spot Trading
      • Orders
        • Add Order - Old
        • Add Order Test - Old
        • Batch Add Orders - Old
        • Cancel Order By OrderId - Old
        • Cancel Order By ClientOid - Old
        • Batch Cancel Order - Old
        • Get Orders List - Old
        • Get Recent Orders List - Old
        • Get Order By OrderId - Old
        • Get Order By ClientOid - Old
        • Get Trade History - Old
        • Get Recent Trade History - Old
    • Margin Trading
      • Get Account Detail - Margin
      • Add Order - V1
      • Add Order Test - V1
      • Get Account List - Isolated Margin - V1
      • Get Account Detail - Isolated Margin - V1
  • Developing
    • Introduction
  1. Private Channels

Order V1

wss://ws-api-spot.kucoin.eu

Topic:/spotMarket/tradeOrders#

Description
This topic will push all change events of your orders.
Push frequency: real-time

Order Status#

"new": the order enters the matching system;
“open”: the order is in the order book（maker order）;
“match”: when taker order executes with orders in the order book, the taker order status is “match”;
“done”: the order is fully executed successfully;

Order Type#

"open": the order is in the order book（maker order）;
"match": the message sent when the order is match,
1.
When the status is open and the type is match, it is a maker match.
2.
When the status is match and the type is match, it is a taker match.
"update": The message sent due to the order being modified: STP triggering, partial cancellation of the order. Includes these three situations:
1.
When the status is open and the type is update: partial amounts of the order have been canceled, or STP triggers
2.
When the status is match and the type is update: STP triggers
3.
When the status is done and the type is update: partial amounts of the order have been filled and the unfilled part got canceled, or STP is triggered.
"filled": The message sent when the status of the order changes to DONE after the transaction
"canceled": The message sent when the status of the order changes to DONE due to being canceled

Subscribe Message#

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/spotMarket/tradeOrders",
  "response": true,
  "privateChannel": "true"
}

Response#

*Data Schema
orderV1

Example
//Open
{
    "topic": "/spotMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "canceledSize": "0",
        "clientOid": "5c52e11203aa677f33e493fb",
        "filledSize": "0",
        "orderId": "6720ecd9ec71f4000747731a",
        "orderTime": 1730211033305,
        "orderType": "limit",
        "originSize": "0.00001",
        "price": "50000",
        "remainSize": "0.00001",
        "side": "buy",
        "size": "0.00001",
        "status": "open",
        "symbol": "BTC-USDT",
        "ts": 1730211033335000000,
        "type": "open"
    }
}
      
//Update
{
    "topic": "/spotMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "canceledSize": "0.00001",
        "clientOid": "5c52e11203aa677f33e493fb",
        "filledSize": "0",
        "oldSize": "0.00002",
        "orderId": "6720df7640e6fe0007b57696",
        "orderTime": 1730207606848,
        "orderType": "limit",
        "originSize": "0.00002",
        "price": "50000",
        "remainSize": "0.00001",
        "side": "buy",
        "size": "0.00001",
        "status": "open",
        "symbol": "BTC-USDT",
        "ts": 1730207616617000000,
        "type": "update"
    }
}
      
//Match
{
    "topic": "/spotMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "canceledSize": "0",
        "clientOid": "5c52e11203aa677f33e493fc",
        "feeType": "takerFee",
        "filledSize": "0.00001",
        "liquidity": "taker",
        "matchPrice": "71171.9",
        "matchSize": "0.00001",
        "orderId": "6720da3fa30a360007f5f832",
        "orderTime": 1730206271588,
        "orderType": "market",
        "originSize": "0.00001",
        "remainSize": "0",
        "side": "buy",
        "size": "0.00001",
        "status": "match",
        "symbol": "BTC-USDT",
        "tradeId": "11116472408358913",
        "ts": 1730206271616000000,
        "type": "match"
    }
}
      
//Filled
{
    "topic": "/spotMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "canceledSize": "0",
        "clientOid": "5c52e11203aa677f33e493fc",
        "filledSize": "0.00001",
        "orderId": "6720da3fa30a360007f5f832",
        "orderTime": 1730206271588,
        "orderType": "market",
        "originSize": "0.00001",
        "remainFunds": "0",
        "remainSize": "0",
        "side": "buy",
        "size": "0.00001",
        "status": "done",
        "symbol": "BTC-USDT",
        "ts": 1730206271616000000,
        "type": "filled"
    }
}

//Canceled
{
    "topic": "/spotMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "canceledSize": "0.00002",
        "clientOid": "5c52e11203aa677f33e493fb",
        "filledSize": "0",
        "orderId": "6720df7640e6fe0007b57696",
        "orderTime": 1730207606848,
        "orderType": "limit",
        "originSize": "0.00002",
        "price": "50000",
        "remainFunds": "0",
        "remainSize": "0",
        "side": "buy",
        "size": "0.00001",
        "status": "done",
        "symbol": "BTC-USDT",
        "ts": 1730207624559000000,
        "type": "canceled"
    }
}

Request

Query Params

Modified at 2025-09-26 10:04:30
Previous
Order V2
Next
Balance