New Order

POST
{BASE_URL}/orders/new

Place a new equity order. The market is determined from the provisioned symbol; there is no separate market field. A 201 response means the request was accepted by the API; use order updates or GET /orders/status for its lifecycle.

Korea requirements

• symbol is the six-digit KRX issue code without a suffix, such as 005930.
• Send security_type: CS and a positive whole-share quantity.
• Use execution_instruction: held and time_in_force: day (blank also defaults to Day).
• order_type may be market or limit. Send price for a limit order and omit it for a market order.
• Supported side/position pairs are buy with position_effect: open and sell with position_effect: close. Korean fractional, notional, short-sale, stop, IOC, GTC, option, multileg, and IPO orders are not supported by this contract.
• Omit trading_session_ids to make the order eligible for both supported sessions. If supplied, use KR2 (regular session, 09:00–15:20 KST), KR3 (closing auction, 15:20–15:30 KST), or KR2 followed by KR3. An accepted order can wait until an eligible session.

A Korean buy on a provisioned USD account is automatically funded into KRW. The automatic conversion has a separate update lifecycle described under Websocket. Clients do not submit, cancel, or modify that funding order directly.

Request

Responses

201

Order request accepted.

400

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.

401

Missing or invalid credentials, or the account is not entitled to the authenticated client.