KUCOIN API
HomeChange LogAPI DOC V1
Language
  • 繁體中文
HomeChange LogAPI DOC V1
Language
  • 繁體中文
SDK
Telegram
Kucoin
  1. Private Channels
  • Introduction
  • Authentication
  • Enums Definitions
  • Terms Definitions
  • SDK
  • Rate Limit
  • Change Log
  • User Service
    • Market Making Incentive Scheme
    • VIP Fast Track
    • Broker Program
  • Unified REST
    • Introduction
    • Market data
      • Get Announcements
      • Get Currency
      • Get Symbol
      • Get Ticker
      • Get OrderBook
      • Get Trades
      • Get Klines
      • Get Current Funding Rate
      • Get History Funding Rate
      • Get Service Status
      • Get Cross Margin Config
      • Get Collateral Ratio
    • Account
      • Get Account(Classic)
      • Get Account(UTA)
      • Get Account Overview(UTA)
      • Get Sub Account
      • Get Transfer Quotas
      • Flex Transfer
      • Set Sub Account Transfer Permission
      • Set Account Mode
      • Get Fee Rate
      • Get Account Ledger
      • Get Interest History(UTA)
      • Modify leverage(UTA)
    • Orders
      • Place Order
      • Batch Place Order(Classic)
      • Cancel Order
      • Batch Cancel Orders(Classic)
      • Get Order Details
      • Get Open Order List
      • Get Order History
      • Get Trade History
      • Set DCP(Classic)
      • Get DCP(Classic)
    • Positions
      • Get Position List(UTA)
      • Get Positions History(UTA)
  • Unified Websocket
    • Base Info
      • Introduction
      • Get Private Token - Unified API Private Channels
    • Public Channels
      • Ticker
      • Trade
      • Orderbook
      • Kline
    • Private Channels
      • Order
      • Position
      • Balance
      • Execution
      • LiquidationWarning
      • Leverage
    • Add/Cancel Order
      • Add Order
      • Cancel Order
  • 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
        • Add sub-account
        • Add sub-account Margin Permission
        • Add sub-account Futures Permission
        • Get sub-account List - Summary Info
        • Get sub-account Detail - Balance
        • Get sub-account List - Spot Balance (V2)
        • Get sub-account List - Futures 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 (V3)
        • Cancel Withdrawal
        • Get Withdrawal History
        • Get Withdrawal History By ID
        • Get KYC Regions
      • Transfer
        • Get Transfer Quotas
        • Flex Transfer
      • Trade Fee
        • Get Basic Fee - Spot/Margin
        • Get Actual Fee - Spot/Margin
        • Get Actual Fee - Futures
    • 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 ETF Info
        • Get Mark Price Detail
        • Get Margin Config
        • Get Mark Price List
        • Get Margin Collateral Ratio
      • 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
        • Get Borrow Interest Rate
        • Borrow
        • Get Borrow History
        • Repay
        • Get Repay History
        • Get Interest History
        • Modify Leverage
      • Credit
        • Get Loan Market
        • Get Loan Market Interest Rate
        • Purchase
        • Modify Purchase
        • Get Purchase Orders
        • Redeem
        • Get Redeem Orders
      • Risk Limit
        • Get Margin Risk Limit
    • Futures Trading
      • Introduction
      • Market Data
        • Get Symbol
        • Get All Symbols
        • Get Ticker
        • Get All Tickers
        • Get Full OrderBook
        • Get Part OrderBook
        • Get Trade History
        • Get Klines
        • Get Mark Price
        • Get Spot Index Price
        • Get Interest Rate Index
        • Get Premium Index
        • Get 24hr stats
        • Get Server Time
        • Get Service Status
      • 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
        • Get Current Funding Rate
        • Get Public Funding History
        • Get Private Funding History
    • 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
      • Simple Earn
        • Purchase
        • Get Redeem Preview
        • Redeem
        • Get Savings Products
        • Get Promotion Products
        • Get Staking Products
        • Get KCS Staking Products
        • Get ETH Staking Products
        • Get Account Holding
      • Structured Earn - Dual
        • Structured Product Purchase
        • Get Dual Investment Products
        • Get Structured Product Orders
    • VIP Lending
      • Introduction
      • Get Collateral Ratio
      • Get Loan Info
      • Get Accounts
    • Affiliate
      • Introduction
      • Get Invited
      • Get Commission
      • Get Trade History
      • Get Transaction
      • Get Kumining
    • Broker
      • Introduction
      • Broker Application
      • Instructions
      • API Broker
        • Introduction
        • Broker Fast API Service
        • Get Broker Rebate
        • Get Commission
        • Get User List
        • Get User Transactions
      • Exchange Broker
        • Introduction
        • 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
        • Get Broker Rebate
    • Convert
      • Introduction
      • Get Convert Symbol
      • Get Convert Currencies
      • Add Convert Order
      • Get Convert Quote
      • Get Convert Order Detail
      • Get Convert Order History
      • Add Convert Limit Order
      • Get Convert Limit Quote
      • Get Convert Limit Order Detail
      • Get Convert Limit Orders
      • Cancel Convert Limit Order
  • Classic Websocket
    • Base Info
      • Introduction
      • Get Public Token - Classic Spot/Margin
      • Get Private Token - Classic Spot/Margin
      • Get Public Token - Classic Futures
      • Get Private Token - Classic Futures
    • Spot Trading
      • Public Channels
        • Ticker
        • All Tickers
        • Orderbook - Level1
        • Orderbook - Level5
        • Orderbook - Level50
        • Orderbook - Increment
        • Call Auction Orderbook - Level50
        • 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
    • Futures Trading
      • Public Channels
        • Ticker V2
        • Ticker V1
        • Orderbook - Level5
        • Orderbook - Level50
        • Orderbook- Increment
        • Klines
        • Trade
        • Instrument
        • Funding Fee Settlement
        • Symbol Snapshot
      • Private Channels
        • Orders
        • Balance
        • Positions
        • Margin Mode
        • Cross Margin Leverage
        • Stop Orders
  • Error Code
    • HTTP
    • Spot
    • Margin
    • Earn
    • Broker
    • CopyTrading
    • Websocket
    • Futures
  • 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
      • 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
    • Futures Trading
      • Modify Isolated Margin Auto-Deposit Status
      • Cancel All Orders - V1
      • Get Position Details - V1
    • Affiliate
      • Get Account
    • Broker
      • API Broker
        • Get Broker Rebate
  • Developing
    • Introduction
  1. Private Channels

Orders

wss://ws-api-futures.kucoin.com

Topic: /contractMarket/tradeOrders#

OR#

Topic: /contractMarket/tradeOrders:{symbol}#

Description
Push order changes for the specified symbol. When symbol is empty, push order changes of all symbols
Push frequency: real-time

Order Status#

“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 when Zero freeze cancel order
"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#

//Get all symbols order change
{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/contractMarket/tradeOrders",
  "response": true,
  "privateChannel": "true"
}  
 
//Get specific symbol order change
{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/contractMarket/tradeOrders:XBTUSDTM",
  "response": true,
  "privateChannel": "true"
}  

Response#

Data Schema
orders

Example
//Open
{
    "topic": "/contractMarket/tradeOrders:XBTUSDTM",
    "type": "message",
    "subject": "symbolOrderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "symbol": "XBTUSDTM",
        "tradeType": "trade",
        "side": "buy",
        "canceledSize": "0",
        "orderId": "247899236673269761",
        "liquidity": "maker",
        "marginMode": "ISOLATED",
        "type": "open",
        "orderTime": 1731916985768138917,
        "size": "1",
        "filledSize": "0",
        "price": "91670",
        "remainSize": "1",
        "status": "open",
        "ts": 1731916985789000000
    }
}
      
      
//Update
{
    "topic": "/contractMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "669a61642857ca000186f626",
    "channelType": "private",
    "data": {
        "symbol": "RUNEUSDTM",
        "orderType": "limit",
        "tradeType": "trade",
        "side": "buy",
        "canceledSize": "1037",
        "orderId": "228685469427204099",
        "liquidity": "maker",
        "marginMode": "ISOLATED",
        "type": "update",
        "userId": "669a61642857ca000186f626",
        "oldSize": "19982",
        "orderTime": 1727336066682194084,
        "size": "19982",
        "filledSize": "0",
        "price": "5.029",
        "remainSize": "11618",
        "clientOid": "10496pp066R679264",
        "status": "open",
        "ts": 1727336066766000000
    }
}
      
//Match
{
    "topic": "/contractMarket/tradeOrders:XBTUSDTM",
    "type": "message",
    "subject": "symbolOrderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "symbol": "XBTUSDTM",
        "orderType": "limit",
        "tradeType": "trade",
        "side": "buy",
        "canceledSize": "0",
        "orderId": "247899236673269761",
        "liquidity": "maker",
        "marginMode": "ISOLATED",
        "type": "match",
        "feeType": "makerFee",
        "orderTime": 1731916985768138917,
        "size": "1",
        "filledSize": "1",
        "price": "91670",
        "matchPrice": "91670",
        "matchSize": "1",
        "remainSize": "0",
        "tradeId": "1794175373644",
        "status": "done",
        "ts": 1731916996762000000
    }
}
   
//Match - "tradeType": "liquid"
{
  "topic": "/contractMarket/tradeOrders:XBTUSDTM",
  "type": "message",
  "subject": "symbolOrderChange",
  "userId": "6356450****001cef524",
  "channelType": "private",
  "data": {
    "symbol": "XBTUSDTM",
    "orderType": "limit",
    "side": "sell",
    "canceledSize": "0",
    "orderId": "440761625608192",
    "liquidity": "taker",
    "marginMode": "ISOLATED",
    "type": "match",
    "feeType": "takerFee",
    "orderTime": 1743146786640000000,
    "size": "3840",
    "filledSize": "1116",
    "price": "84603.44",
    "matchPrice": "85739.69",
    "matchSize": "1000",
    "remainSize": "2724",
    "tradeId": "1740800012709",
    "tradeType": "liquid",
    "status": "match",
    "ts": 1743146786746000000
  }
}

//Match - "tradeType": "adl"
{
    "topic": "/contractMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "665d1df19c51ab0001029a49",
    "channelType": "private",
    "data": {
        "symbol": "10PEPEUSDTM",
        "orderType": "limit",
        "side": "sell",
        "canceledSize": "0",
        "orderId": "1961728417792",
        "positionSide": "BOTH",
        "liquidity": "taker",
        "marginMode": "ISOLATED",
        "type": "match",
        "feeType": "takerFee",
        "orderTime": 1750839892050000000,
        "size": "100",
        "filledSize": "100",
        "price": "0.0000126",
        "matchPrice": "0.0000126",
        "matchSize": "100",
        "remainSize": "0",
        "tradeId": "1750839397535",
        "tradeType": "adl",
        "status": "match",
        "ts": 1750839892050000000
    }
}
      
      
//Filled
{
    "topic": "/contractMarket/tradeOrders:XBTUSDTM",
    "type": "message",
    "subject": "symbolOrderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "symbol": "XBTUSDTM",
        "orderType": "limit",
        "tradeType": "trade",
        "side": "buy",
        "canceledSize": "0",
        "orderId": "247899236673269761",
        "marginMode": "ISOLATED",
        "type": "filled",
        "orderTime": 1731916985768138917,
        "size": "1",
        "filledSize": "1",
        "price": "91670",
        "remainSize": "0",
        "status": "done",
        "ts": 1731916996762000000
    }
}

//Filled - "tradeType": "adl"
{
    "topic": "/contractMarket/tradeOrders",
    "type": "message",
    "subject": "orderChange",
    "userId": "665d1df19c51ab0001029a49",
    "channelType": "private",
    "data": {
        "symbol": "10PEPEUSDTM",
        "orderType": "limit",
        "side": "sell",
        "canceledSize": "0",
        "orderId": "1961728417792",
        "positionSide": "BOTH",
        "marginMode": "ISOLATED",
        "type": "filled",
        "orderTime": 1750839892050000000,
        "size": "100",
        "filledSize": "100",
        "price": "0.0000126",
        "remainSize": "0",
        "tradeType": "adl",
        "status": "done",
        "ts": 1750839892050000000
    }
}
      
      
//Canceled
{
    "topic": "/contractMarket/tradeOrders:XBTUSDTM",
    "type": "message",
    "subject": "symbolOrderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "symbol": "XBTUSDTM",
        "orderType": "limit",
        "tradeType": "trade",
        "side": "buy",
        "canceledSize": "1",
        "orderId": "247901211536203776",
        "marginMode": "ISOLATED",
        "type": "canceled",
        "orderTime": 1731917456611809239,
        "size": "1",
        "filledSize": "0",
        "price": "90000",
        "remainSize": "0",
        "status": "done",
        "ts": 1731917460806000000
    }
}
      

      

Request

Query Params

Modified at 2025-09-26 10:04:30
Previous
Symbol Snapshot
Next
Balance