Place a Taiwan order
POST{BASE_URL}/tw/orders/new
Places a whole-quantity Taiwan equity (CS) order. security_type
defaults to CS when omitted.
Supported orders currently use execution_instruction=held,
time_in_force=day, and order_type=market|limit. Taiwan equities
must use whole share quantities. Do not submit notional orders.
Submit a TWD cash account returned by /tw/accounts; margin accounts
are rejected.
Any supported order is accepted during the regular session and closing auction (09:00-13:30 Taipei time). At other times the API accepts only limit orders from a TWD account and rejects everything else because the market is closed.
Coming soon (not supported yet): USD accounts and USD/TWD FX.
- A Taiwan equity buy submitted from a USD account will be funded by
linked AutoFX orders created automatically. Those FX orders will be
visible through
/tw/orders?security_type=FORand WebSocket updates, and theirparent_av_order_idwill point to the equity order. - A standalone FX (
FOR) order will usesymbol=USD/TWD, withquantityas the USD amount. It will be submitted from the account holding the currency being converted from: the USD account forside=selland the TWD account forside=buy. The converted balance will land in the linked account.
Request
Responses
- 201
- 400
- 401
- 403
- 500
- 503
Order 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.