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 :
| Field | Type | Explanation |
|---|---|---|
| instId | String | Product ID |
| orderId | String | Order ID |
| clientOid | String | Client Order ID |
| baseCoin | String | Base asset |
| quoteCoin | String | Quote asset |
| price | String | Price of the order |
| size | String | Quantity of orders (the number of quoted assets when buying, the number of base assets when selling) |
| notional | String | Order amount (when buying at market price) |
| orderType | String | Order type: limit/market |
| force | String | Order valid period: gtc/ioc/fok/post-only/gtd |
| expireTime | String | Expire time |
| side | String | Order side: buy/sell |
| fillPrice | String | Latest transaction price |
| tradeId | String | Latest transaction ID |
| baseVolume | String | Latest transaction quantity |
| fillTime | String | Latest transaction timestamp (milliseconds) |
| fillFee | String | Latest transaction fee |
| fillFeeCoin | String | Asset of transaction fee |
| tradeScope | String | Liquidity direction: taker/maker |
| accBaseVolume | String | Cumulative executed quantity |
| priceAvg | String | Average trade price |
| status | String | Order status: live/partially_filled/filled/canceled |
| feeDetail | Array | Fee details |
| enterPointSource | String | Order source |
| newSize | String | Limit is the base coin quantity; market buy is the quoted coin quantity; market sell is the base coin quantity |
| cTime | String | Create timestamp (milliseconds) |
| uTime | String | Update timestamp (milliseconds) |
