Private Order Change

Topic: /spotMarket/tradeOrders

• Push frequency: real-time

This topic will push all change events of your orders.

Order Status

“match”: when taker order executes with orders in the order book, the taker order status is “match”;

“open”: the order is in the order book;

“done”: the order is fully executed successfully;

Message Type

open

{
  "type": "message",
  "topic": "/spotMarket/tradeOrders",
  "subject": "orderChange",
  "channelType": "private",
  "data": {
    "symbol": "KCS-USDT",
    "orderType": "limit",
    "side": "buy",
    "orderId": "5efab07953bdea00089965d2",
    "type": "open",
    "orderTime": 1670329987026,
    "size": "0.1",
    "filledSize": "0",
    "price": "0.937",
    "clientOid": "1593487481000906",
    "remainSize": "0.1",
    "status": "open",
    "ts": 1670329987311000000
  }
}

when the order enters into the order book;

match

{
  "type": "message",
  "topic": "/spotMarket/tradeOrders",
  "subject": "orderChange",
  "channelType": "private",
  "data": {
    "symbol": "KCS-USDT",
    "orderType": "limit",
    "side": "sell",
    "orderId": "5efab07953bdea00089965fa",
    "liquidity": "taker",
    "type": "match",
    "feeType": "takerFee", //Fee type, this parameter is only included when type=match, message type: "takerFee", "makerFee"
    "orderTime": 1670329987026,
    "size": "0.1",
    "filledSize": "0.1",
    "price": "0.938",
    "matchPrice": "0.96738",
    "matchSize": "0.1",
    "tradeId": "5efab07a4ee4c7000a82d6d9",
    "clientOid": "1593487481000313",
    "remainSize": "0",
    "status": "match",
    "ts": 1670329987311000000
  }
}

when the order has been executed;

filled

{
  "type": "message",
  "topic": "/spotMarket/tradeOrders",
  "subject": "orderChange",
  "channelType": "private",
  "data": {
    "symbol": "KCS-USDT",
    "orderType": "limit",
    "side": "sell",
    "orderId": "5efab07953bdea00089965fa",
    "type": "filled",
    "orderTime": 1670329987026,
    "size": "0.1",
    "filledSize": "0.1",
    "price": "0.938",
    "clientOid": "1593487481000313",
    "remainSize": "0",
    "status": "done",
    "ts": 1670329987311000000
  }
}

when the order has been executed and its status was changed into DONE;

canceled

{
  "type": "message",
  "topic": "/spotMarket/tradeOrders",
  "subject": "orderChange",
  "channelType": "private",
  "data": {
    "symbol": "KCS-USDT",
    "orderType": "limit",
    "side": "buy",
    "orderId": "5efab07953bdea00089965d2",
    "type": "canceled",
    "orderTime": 1670329987026,
    "size": "0.1",
    "filledSize": "0",
    "price": "0.937",
    "clientOid": "1593487481000906",
    "remainSize": "0",
    "status": "done",
    "ts": 1670329987311000000
  }
}

when the order has been cancelled and its status was changed into DONE;

update

{
  "type": "message",
  "topic": "/spotMarket/tradeOrders",
  "subject": "orderChange",
  "channelType": "private",
  "data": {
    "symbol": "KCS-USDT",
    "orderType": "limit",
    "side": "buy",
    "orderId": "5efab13f53bdea00089971df",
    "type": "update",
    "oldSize": "0.1",
    "orderTime": 1670329987026,
    "size": "0.06",
    "filledSize": "0",
    "price": "0.937",
    "clientOid": "1593487679000249",
    "remainSize": "0.06",
    "status": "open",
    "ts": 1670329987311000000
  }
}

when the order has been updated;