訂單 V2

Topic:/spotMarket/tradeOrdersV2

Description

此主題將推送您的訂單的所有變更事件。與 v1 相比，v2 增加了訂單狀態「new」，推送速度無差異。

推送頻率: 實時

訂單狀態

"new": 訂單進入匹配系統;

“open”: 訂單在訂單簿中（maker 訂單）;

“match”: 當 taker 訂單與訂單簿中的訂單成交時，taker 訂單狀態為「match」;

“done”: 訂單完全成功執行;

訂單類型

「received」：訂單進入匹配系統時發送的消息。當訂單剛進入匹配系統且尚未與對方進行匹配邏輯時，將推送一條消息類型為「received」且訂單狀態為「new」的私人消息。

「open」：訂單在訂單簿中（maker 訂單）；

「match」：訂單成交時發送的消息，

當狀態為 open 且類型為 match 時，為 maker 成交。

當狀態為 match 且類型為 match 時，為 taker 成交。

「update」：因訂單被修改而發送的消息：STP 觸發、訂單部分取消。包括以下三種情況：

當狀態為 open 且類型為 update：訂單部分數量被取消，或 STP 觸發。

當狀態為 match 且類型為 update：STP 觸發。

當狀態為 done 且類型為 update：訂單部分數量已成交，未成交部分被取消，或 STP 觸發。

「filled」：訂單狀態變更為 DONE 後，因交易完成而發送的消息。

「canceled」：訂單因被取消而狀態變更為 DONE 時發送的消息。

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

Response

Data Schema

orderV2

Example

//received
{
    "topic": "/spotMarket/tradeOrdersV2",
    "type": "message",
    "subject": "orderChange",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private",
    "data": {
        "clientOid": "5c52e11203aa677f33e493fc",
        "orderId": "6720da3fa30a360007f5f832",
        "orderTime": 1730206271588,
        "orderType": "market",
        "originSize": "0.00001",
        "side": "buy",
        "status": "new",
        "symbol": "BTC-USDT",
        "ts": 1730206271616000000,
        "type": "received"
    }
}

//Open
{
    "topic": "/spotMarket/tradeOrdersV2",
    "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/tradeOrdersV2",
    "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/tradeOrdersV2",
    "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/tradeOrdersV2",
    "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/tradeOrdersV2",
    "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"
    }
}

Topic:/spotMarket/tradeOrdersV2#

訂單狀態#

訂單類型#

Subscribe Message#

Response#

Request

Topic:/spotMarket/tradeOrdersV2

訂單狀態

訂單類型

Subscribe Message

Response