KR Orders Acceptance
Which orders are accepted depends on the time of day in Korea Standard Time (KST, UTC+9). Orders can be placed outside trading hours: they wait and are sent to the exchange when their first selected session opens.
Trading Sessions
| Session | Time (KST) | Notes |
|---|---|---|
KR1 Opening auction | 08:30 – 09:00 | |
KR2 Regular session | 09:00 – 15:20 | |
KR3 Closing auction | 15:20 – 15:30 | |
KR4 After-market | 16:00 – 20:00 | Not available yet. Orders that list KR4 are rejected. |
Sessions follow the KRX trading calendar. Start times are inclusive and end times are exclusive. GET /kr/market/status returns the current regime.
Use trading_session_ids to choose sessions. Any ascending combination of KR1, KR2 and KR3 is valid, for example ["KR2"] or ["KR2", "KR3"]. When you omit it, the order is eligible for KR1, KR2 and KR3. A modify keeps the original order's sessions.
Equities (CS)
| Time (KST) | Order types accepted | When the order trades | TIF | Modifies | Short selling |
|---|---|---|---|---|---|
09:00 – 15:30 (KR2, KR3) | market, limit | Immediately, if the current session is selected | Day | Yes | See below |
08:30 – 09:00 (KR1) | limit (KRW account) | In the opening auction if KR1 is selected, otherwise from 09:00 | Day | Limit only | See below |
| All other times, weekends and KRX holidays | limit (KRW account) | When the first selected session opens | Day | Limit only | See below |
Outside 09:00 – 15:30 KST, any order other than a limit order from a KRW account is rejected with DisallowedOrderAction_Error (market is closed). The same rule applies to modifies.
Order rules
- Use whole share quantities and
execution_instruction: held. priceis required for limit orders and must be omitted for market orders.time_in_forcemust beday, or omitted.- Not supported: notional and fractional orders, stop and stop-limit orders, IOC and GTC, OCO, multileg and IPO orders.
Day order expiry
A day order expires at the end of the last session it selects: 09:00 for KR1, 15:20 for KR2 and 15:30 for KR3 (the default). An order placed after that time on a trading day, or on a non-trading day, is an order for the next KRX trading day. Expired orders are canceled and you receive a canceled WebSocket update.
Modifies
- Send
order_typeand, for limit orders,priceagain; they are not carried over from the original order. side,position_effect,symbol,end_customer_idand the selected sessions come from the original order.- The new quantity must be a whole number and greater than the quantity already filled.
- Exchange amend rules apply: an amend can change the price or order type, or reduce the quantity, but not both in one request, and it cannot increase the quantity. The API accepts these requests and the broker rejects them. A rejected amend arrives as a
replace_rejectedWebSocket update and the original order keeps working.
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 /kr/equities, and an account enabled for short selling. To sell shares you hold, use side: sell with position_effect: close.
FX (FOR)
Standalone USD/KRW FX orders and USD-funded equity buys (AutoFX) are not supported yet. See KR Trading for a preview of how they will work.
See Risk Limits for the checks every order goes through.