Order updates
Real-time order state updates. Requires authentication.
Subscribe
{"op": "subscribe", "args": ["orders"]}
Topic format: orders (per-account, not per-symbol).
Update Message
Pushed on each order state change. Each message is a full replacement of the order state — there are no partial deltas.
{
"channel": "orders",
"type": "update",
"code": "f1e2d3c4-b5a6-7890-fedc-ba9876543210",
"customer_code": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
"symbol": "BTCUSDC_PERP",
"action": "buy",
"order_type": "limit",
"status": "filled",
"amount": "100",
"filled_amount": "100",
"limit_price": "67500.00",
"stop_loss_price": null,
"take_profit_price": null,
"average_fill_price": "67498.50",
"time_in_force": "GTC",
"expire_time": null,
"reference_id": "my-order-001",
"reason": null,
"timestamp": "2025-06-15T07:30:01.456Z"
}
| Field | Description |
|---|---|
code | Unique order identifier |
customer_code | Customer identifier |
symbol | Instrument symbol |
action | buy or sell |
order_type | market, limit, stop_market, stop_limit, or take_profit_stop_loss |
status | open, canceled_partially_filled, filled, canceled, expired, or rejected |
amount | Original order amount in contracts |
filled_amount | Cumulative filled amount |
limit_price | Limit price (null for market orders) |
trigger_price | Trigger price (null for non-stop orders) |
stop_loss_price | Stop-loss trigger price (null for non-TakeProfitStopLoss orders) |
take_profit_price | Take-profit trigger price (null for non-TakeProfitStopLoss orders) |
average_fill_price | Volume-weighted average fill price (null if no fills) |
time_in_force | GTC, IOC, FOK, or GTD |
expire_time | Expiration time for GTD orders |
reference_id | Client-assigned order identifier |
reason | Rejection or cancellation reason |
timestamp | Server-side event time (maps to updated in REST) |
Notes:
- There is no initial snapshot on subscribe — use REST
GET /ordersfor current state. order_typecorresponds totypein the REST Order schema (renamed to avoid collision with the messagetypefield).timestampcorresponds toupdatedin the REST Order schema.