modifyConditionalOrder
Modify a conditional order by replacing its full configuration, including trigger price, order type, and expire date. After modification, a new order ID is issued.
Instructions
조건주문 수정
조건주문을 수정합니다. 조건주문 전체를 재설정하므로 본문에 type·expireDate·first(필요 시 second) 를 모두 전달합니다.
수량(quantity)은 각 감시 조건(first/second) 안에 입력합니다.
(등록과 달리 expireDate 가 필수입니다.) 종목은 conditionalOrderId 로 식별되므로 본문에 symbol 은 필요 없습니다.
본문의 type 은 변경 결과 타입이며, 타입 전환(예: SINGLE→OCO)이 허용됩니다. 응답의 type 으로 확인하세요.
conditionalOrderId 로 수정 대상을 식별합니다.
주의: 수정은 기존 조건주문을 취소하고 새 조건주문을 생성하는 방식으로 동작합니다.
따라서 수정 후에는 새로운 conditionalOrderId 가 발급되고 기존 ID 는 무효화됩니다.
이후 조회·수정·취소에는 반드시 응답으로 반환된 conditionalOrderId 를 사용하세요.
Rate Limits Group: CONDITIONAL_ORDER
[POST /api/v1/conditional-orders/{conditionalOrderId}/modify]
tags: Conditional Order
⚠️ 실제 자산에 영향을 주는 조건주문 API 입니다. 기본값은 dryRun=true 이며 실행하려면 TOSSINVEST_ENABLE_CONDITIONAL_ORDERS=true 와 confirmation 이 필요합니다.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | 조건주문 수정 요청. 등록과 동일하게 "이 가격에 닿으면 매매" 만 입력하며, 조건주문 전체를 재설정하므로 유지할 조건도 함께 전달해야 합니다. 종목은 `conditionalOrderId` 로 식별되므로 수정 요청에는 `symbol` 이 필요 없습니다. | |
| path | Yes | URL 경로 파라미터 | |
| dryRun | No | 기본값 true. true 이면 토스증권 서버로 어떤 네트워크 요청도 보내지 않고 실행 계획만 반환합니다. 실제 주문을 내려면 false 로 명시해야 합니다. | |
| account | No | 요청에 사용할 계좌의 accountSeq. getAccounts 응답의 accountSeq 값을 사용합니다. 미지정 시 TOSSINVEST_DEFAULT_ACCOUNT 환경변수를 사용하며, 둘 다 없으면 호출하지 않고 오류를 반환합니다. | |
| confirmation | No | 실주문 확인 문자열. TOSSINVEST_MUTATION_CONFIRMATION 환경변수 값과 정확히 일치해야 실제 주문이 실행됩니다. |