Prepare conditional stock order
toss_prepare_conditional_orderPreview a conditional order (SINGLE, OCO, OTO) that waits for a trigger price, returning a token for later approval. For take-profit/stop-loss pairs, no trade is placed.
Instructions
Previews a NEW conditional order that stays dormant until its trigger price is reached. SINGLE arms one leg. OCO arms two legs where filling either one cancels the other (typical take-profit plus stop-loss pair). OTO arms a second leg that is placed only after the first leg fills. For an order that should execute right away use toss_prepare_order instead. Nothing reaches the market from this call: it only validates the request and returns a preview plus a confirmation token. Show that preview to the user, obtain explicit approval, then pass the token to toss_submit_prepared_order. The token is single-use and expires 60 seconds after this call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | SINGLE uses `first` only. OCO and OTO both require `second`. | |
| first | Yes | Primary leg, armed as soon as the order is accepted. | |
| second | No | Second leg. Required for OCO and OTO; must be omitted for SINGLE. | |
| symbol | Yes | Korean 6-digit code (e.g. '005930') or US ticker (e.g. 'NVDA'). Call toss_resolve_symbol first if you only have a company name. | |
| quantity | Yes | Share count for the order, as a positive decimal string. | |
| orderType | Yes | LIMIT requires `orderPrice` on every leg. MARKET forbids it. OCO and OTO accept LIMIT only. | |
| expireDate | Yes | Last KST date the condition stays armed, formatted YYYY-MM-DD, e.g. '2026-12-31'. |