HK Orders Acceptance
Hong Kong orders are accepted at any time, including weekends and holidays. Orders placed outside their sessions wait and are sent to the exchange when their first selected session opens. Times are Hong Kong Time (HKT, UTC+8).
Trading Sessions
| Session | trading_session_ids value | Time (HKT) |
|---|---|---|
| Pre-opening auction | 1 | 09:00 – 09:30 |
| Continuous trading, morning | 2 | 09:30 – 12:00 |
| Lunch break | — | 12:00 – 13:00. Orders are held until 13:00. |
| Continuous trading, afternoon | 2 | 13:00 – 16:00 |
| Closing auction | 3 | 16:00 – 16:10 |
On half-day trading days, there is no afternoon session and the closing auction runs from 12:00 to 12:10. Sessions follow the HKEX trading calendar. GET /market/status returns the current regime.
Valid trading_session_ids values are 1, 2, 3, 1,2, 2,3 and 1,2,3. When you omit it, the order trades in continuous trading only and never in an auction. To take part in an auction, include 1 or 3.
Stocks, ETFs, Warrants and Bonds
| Time (HKT) | Order types accepted | When the order trades | TIF accepted | Modifies | Short selling |
|---|---|---|---|---|---|
| 09:00 – 09:30 | market, limit, stop, stop-limit | In the pre-opening auction if 1 is selected, otherwise from 09:30 | Day, IOC, GTC | Yes | See below |
| 09:30 – 12:00, 13:00 – 16:00 | market, limit, stop, stop-limit | Immediately, if 2 is selected or sessions are omitted | Day, IOC, GTC | Yes | See below |
| 12:00 – 13:00 | market, limit, stop, stop-limit | From 13:00 | Day, IOC, GTC | Yes | See below |
| 16:00 – 16:10 | market, limit, stop, stop-limit | In the closing auction if 3 is selected. Otherwise, Day orders expire at 16:10 without trading and GTC orders trade the next trading day | Day, IOC, GTC | Yes | See below |
| All other times, weekends and HKEX holidays | market, limit, stop, stop-limit | When the first selected session opens | Day, IOC, GTC | Yes | See below |
Stop and stop-limit orders are accepted by the API. Contact Atomic Vaults before using them in production.
Order rules
- Use whole share quantities and
execution_instruction: held. Orders should be in multiples of the stock's board lot; Atomic Vaults does not check the lot size. priceis required for limit and stop-limit orders, andstop_pricefor stop and stop-limit orders.- Not supported: notional and fractional orders,
execution_instruction: not_heldandtime_in_force: gft. - Coming soon: options, multileg and OCO orders.
Time in force
- Day (default) orders expire at the end of the closing auction: 16:10 HKT, or 12:10 on half-day trading days. An order placed after 16:10 expires at 16:10 on the next calendar day.
- IOC orders cannot be canceled or modified.
- GTC orders stay open until they fill or you cancel them. They are re-entered at the exchange each trading day.
Modifies
side,position_effect,symbolandend_customer_idcome from the original order.trading_session_idsis not carried over. Send it again, or the replacement trades in continuous trading only.- The new quantity must be a whole number.
- IPO orders cannot be modified. Cancel the order and place a new one.
Short selling
Opening a short position requires side: sell_short or sell_short_exempt, a symbol whose easy_to_borrow flag is true in GET /equities, and an account enabled for short selling. To sell shares you hold, use side: sell with position_effect: close.
IPO Subscriptions
IPO orders are placed with POST /orders/new/ipo:
- Market orders only. Limit and stop orders are rejected.
- IPO orders are good until canceled and are sent for subscription at any time of day.
- IPO orders cannot be modified. Cancel with
POST /orders/cancel/ipo.
See Risk Limits for the checks every order goes through.