Order Channel

Channel name : orders

Description : Get order information. Pushes will occur when the following events take place: order placement, order execution, order cancellation, and order modification. Subscription is only supported for specified trading pairs.

Subscription requests :

{
  "op": "subscribe",
  "args": [
    {
      "instType": "SPOT",
      "channel": "orders",
      "instId": "AVAXHKD"
    }
  ]
}

Push data format (using limit price to buy AVAXHKD as an example):

The order was not filled and was placed on the order book. (status: live):

{
  "action": "update",
  "arg": {
    "channel": "orders",
    "instType": "SPOT",
    "instId": "AVAXHKD"
  },
  "data": [
    {
      "instId": "AVAXHKD",
      "baseCoin": "AVAX",
      "quoteCoin": "HKD",
      "orderId": "2268958820897454336",
      "clientOid": "78ad4d23-b916-4f00-a080-1a3da0a44c18",
      "price": "52.61",
      "size": "99.97",
      "newSize": "1.90",
      "notional": "99.97",
      "orderType": "limit",
      "force": "gtc",
      "expireTime": null,
      "side": "buy",
      "accBaseVolume": "0",
      "priceAvg": "0",
      "status": "live",
      "cTime": "1785216969056",
      "uTime": "1785216969060"
    }
  ],
  "ts": 1785216969081 //event push timestamp
}

The order was partially filled. (status: partially_filled):

{
  "action": "update",
  "arg": {
    "channel": "orders",
    "instType": "SPOT",
    "instId": "AVAXHKD"
  },
  "data": [
    {
      "instId": "AVAXHKD",
      "baseCoin": "AVAX",
      "quoteCoin": "HKD",
      "orderId": "2268962429961828608",
      "clientOid": "fb19a502-44d9-4e0e-869b-357a4431f401",
      "price": "52.62",
      "size": "52.63",
      "newSize": "1.00",
      "notional": "52.63",
      "orderType": "limit",
      "force": "gtc",
      "expireTime": null,
      "side": "buy",
      "fillPrice": "52.62000000",
      "tradeId": "2268962683784329474",
      "baseVolume": "0.30000000",
      "fillTime": "1785217429551",
      "fillFee": "-0.00157860",
      "fillFeeCoin": "HKD",
      "tradeScope": "maker",
      "accBaseVolume": "0.30",
      "priceAvg": "52.62",
      "status": "partially_filled",
      "feeDetail": [
        {
          "feeCoin": "HKD",
          "fee": "-0.00157860"
        }
      ],
      "cTime": "1785217399289",
      "uTime": "1785217429551"
    }
  ],
  "ts": 1785217429571
}

The order was fully filled (status: filled).

{
  "action": "update",
  "arg": {
    "channel": "orders",
    "instType": "SPOT",
    "instId": "AVAXHKD"
  },
  "data": [
    {
      "instId": "AVAXHKD",
      "baseCoin": "AVAX",
      "quoteCoin": "HKD",
      "orderId": "2268962683784329472",
      "clientOid": "5f67a425-8261-4fb7-aa2d-fe172c4b602f",
      "price": "52.62",
      "size": "0.30",
      "newSize": "0.30",
      "notional": "15.78",
      "orderType": "limit",
      "force": "gtc",
      "expireTime": null,
      "side": "sell",
      "fillPrice": "52.62000000",
      "tradeId": "2268962683784329474",
      "baseVolume": "0.30000000",
      "fillTime": "1785217429551",
      "fillFee": "-0.00315720",
      "fillFeeCoin": "HKD",
      "tradeScope": "taker",
      "accBaseVolume": "0.30",
      "priceAvg": "52.62",
      "status": "filled",
      "feeDetail": [
        {
          "feeCoin": "HKD",
          "fee": "-0.00315720"
        }
      ],
      "cTime": "1785217429547",
      "uTime": "1785217429551"
    }
  ],
  "ts": 1785217429572
}

Field description :

FieldTypeExplanation
instIdStringProduct ID
orderIdStringOrder ID
clientOidStringClient Order ID
baseCoinStringBase asset
quoteCoinStringQuote asset
priceStringPrice of the order
size
StringQuantity of orders (the number of quoted assets when buying, the number of base assets when selling)
notionalStringOrder amount (when buying at market price)
orderTypeStringOrder type: limit/market
forceStringOrder valid period: gtc/ioc/fok/post-only/gtd
expireTimeStringExpire time
sideStringOrder side: buy/sell
fillPriceStringLatest transaction price
tradeIdStringLatest transaction ID
baseVolumeStringLatest transaction quantity
fillTimeStringLatest transaction timestamp (milliseconds)
fillFeeStringLatest transaction fee
fillFeeCoinStringAsset of transaction fee
tradeScopeStringLiquidity direction: taker/maker
accBaseVolumeStringCumulative executed quantity
priceAvgStringAverage trade price
statusStringOrder status: live/partially_filled/filled/canceled
feeDetailArrayFee details
enterPointSourceStringOrder source
newSizeStringLimit is the base coin quantity;
market buy is the quoted coin quantity;
market sell is the base coin quantity
cTimeStringCreate timestamp (milliseconds)
uTimeStringUpdate timestamp (milliseconds)