訂單
wss://ws-api-futures.kucoin.com
Topic: /contractMarket/tradeOrders
OR
Topic: /contractMarket/tradeOrders:{symbol}
Description
訂單狀態
訂單類型
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
訂單
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-08-28 07:08:43