New IPO Order
POST{BASE_URL}/orders/new/ipo
Places a new IPO subscription order. IPO orders must be market orders
and are persisted as time_in_force=gtc; a supplied time in force is
overridden by the API.
symbol must be a current IPO from GET /ipos, written without the
.HK suffix or leading zeros (2667.HK → 2667); other symbols fail
with DisallowedOrderAction_Error. With client_ref, quantity must
be a multiple of the IPO's minimum subscription lot (MinSubNum).
IPO orders cannot be modified; cancel and place a new order instead.
Request
Responses
- 201
- 400
- 401
- 403
- 500
- 503
IPO subscription accepted.
The request could not be accepted, for example because the account or
symbol is unavailable, a required paired account is missing, buying power
or position is insufficient, required market pricing is unavailable, an
identifier is duplicated, or an order field or requested lifecycle action
is invalid. A missing account_number, or one not linked to the API key,
also returns 400 BasicInput_Error.
Missing or invalid X-API-KEY.
The API key is read-only and the request is not a GET.
Unexpected server-side failure, for example the order service did not
answer in time (AVInternal_Error, system too busy) or was
unreachable (Misc_Error). For order requests, check the order's
status before retrying: a retried order_id that was already
accepted is rejected as a duplicate.
A required service is temporarily unavailable (for example the database, or for Hong Kong requests that read from GigaMoney Whale, the Whale connection). Retry later.