Skip to main content

New Order

POST

{BASE_URL}/orders/new

Places a Hong Kong equity order.

Coming soon (not available yet): option orders and OCO orders. The option and OCO fields describe their planned behavior as a preview: an option will be identified either by its OCC symbol, or by underlying, expiration_date, option_type and strike_price; an OCO equity order will set order_class=oco and provide both take_profit_leg and stop_loss_leg.

  • Orders must use execution_instruction=held and a whole-number quantity. Fractional quantities and notional orders are not supported: a fractional quantity fails with BasicInput_Error, and not_held fails with DisallowedOrderAction_Error.
  • symbol is the HKEX stock code without leading zeros or suffix (700, not 00700 or 0700.HK). Other forms fail with Instrument_Error: security not found.
  • Sell to open must use sell_short or sell_short_exempt (only for easy-to-borrow stocks); sell to close must use sell.

A 201 means the order was accepted and saved. Fills, rejection by the venue and cancellation are reported on the WebSocket and by GET /orders/status. Orders received outside a trading session stay new until the next session they are eligible for.

Request​

Responses​

Order accepted. Track it on the WebSocket or with GET /orders/status.