# ConditionalOrderApi

All URIs are relative to *https://openapi.tossinvest.com*

| Method | HTTP request | Description |
|------------- | ------------- | -------------|
| [**cancelConditionalOrder**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/ConditionalOrderApi.md#cancelConditionalOrder) | **DELETE** /api/v1/conditional-orders/{conditionalOrderId} | 조건주문 취소 |
| [**createConditionalOrder**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/ConditionalOrderApi.md#createConditionalOrder) | **POST** /api/v1/conditional-orders | 조건주문 생성 |
| [**modifyConditionalOrder**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Apis/ConditionalOrderApi.md#modifyConditionalOrder) | **POST** /api/v1/conditional-orders/{conditionalOrderId}/modify | 조건주문 수정 |


<a name="cancelConditionalOrder"></a>
# **cancelConditionalOrder**
> cancelConditionalOrder(X-Tossinvest-Account, conditionalOrderId)

조건주문 취소

    조건주문을 취소합니다. `conditionalOrderId` 로 취소 대상을 식별합니다.  **Rate Limits Group**: `CONDITIONAL_ORDER` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **X-Tossinvest-Account** | **Long**| API 요청 시 사용할 계좌의 accountSeq. `GET /api/v1/accounts` 응답의 `accountSeq` 값을 사용합니다.  | [default to null] |
| **conditionalOrderId** | **String**| 조건주문 식별자 | [default to null] |

### Return type

null (empty response body)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

<a name="createConditionalOrder"></a>
# **createConditionalOrder**
> createConditionalOrder_200_response createConditionalOrder(X-Tossinvest-Account, ConditionalOrderCreateRequest)

조건주문 생성

    특정 종목의 가격을 감시해 조건 충족 시 자동으로 매매(매수/매도)하는 조건주문을 생성합니다.  감시가와 매매 방향(매수/매도)을 설정한 후 가격이 감시가에 도달하면 조건이 발동되어 주문이 생성됩니다.  **발동 세션**: 조건 감시·발동 세션은 시장에 따라 다릅니다. - 국내 주식: KRX 정규장에서만 발동됩니다. - 해외 주식: 장 구분과 상관없이, 거래 가능한 모든 시간대에 발동됩니다.  **타입(`type`)** — 조건의 개수와 관계를 정합니다: - `SINGLE`: `first` 한 조건만 감시합니다. - `OCO` (One-Cancels-the-Other): 두 조건(`first`·`second`)을 동시에 감시하다, 하나의 조건이 충족되면 나머지 조건은 자동 취소됩니다.   `first`/`second` 모두 **매도(SELL)** 이며 `first` 감시가 > 현재가 > `second` 감시가 여야 합니다. 호가유형은 지정가(`LIMIT`)만 지원합니다. - `OTO` (One-Triggers-the-Other): `first` 조건이 체결되면 그때부터 `second` 조건 감시가 시작됩니다.   `first` 는 **매수(BUY)**, `second` 는 **매도(SELL)** 입니다. 호가유형은 지정가(`LIMIT`)만 지원합니다.  **Rate Limits Group**: `CONDITIONAL_ORDER` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **X-Tossinvest-Account** | **Long**| API 요청 시 사용할 계좌의 accountSeq. `GET /api/v1/accounts` 응답의 `accountSeq` 값을 사용합니다.  | [default to null] |
| **ConditionalOrderCreateRequest** | [**ConditionalOrderCreateRequest**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/ConditionalOrderCreateRequest.md)|  | |

### Return type

[**createConditionalOrder_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/createConditionalOrder_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json

<a name="modifyConditionalOrder"></a>
# **modifyConditionalOrder**
> modifyConditionalOrder_200_response modifyConditionalOrder(X-Tossinvest-Account, conditionalOrderId, ConditionalOrderModifyRequest)

조건주문 수정

    조건주문을 수정합니다. 조건주문 전체를 재설정하므로 본문에 `type`·`quantity`·`orderType`·`expireDate`·`first`(필요 시 `second`) 를 모두 전달합니다. 종목은 `conditionalOrderId` 로 식별되므로 본문에 `symbol` 은 필요 없습니다. 본문의 `type` 은 변경 결과 타입이며, 타입 전환(예: SINGLE→OCO)이 허용됩니다. 응답의 `type` 으로 확인하세요.  `conditionalOrderId` 로 수정 대상을 식별합니다.  **주의**: 수정은 기존 조건주문을 취소하고 새 조건주문을 생성하는 방식으로 동작합니다. 따라서 수정 후에는 **새로운 `conditionalOrderId` 가 발급되고 기존 ID 는 무효화**됩니다. 이후 조회·수정·취소에는 반드시 응답으로 반환된 `conditionalOrderId` 를 사용하세요.  **수정 가능 상태**: 감시 중(`WATCHING`)·일시정지(`PAUSED`) 조건주문만 수정할 수 있습니다. 조건이 충족되어 주문이 생성 중(`ORDERING`)이거나 주문이 접수된(`ORDERED`) 조건주문, 종료된(`COMPLETED`·`EXPIRED`) 조건주문은 `422 modify-restricted` 로 거절됩니다. 감시 중이라도 조건 충족 여부를 판정하는 중에는 거절될 수 있습니다. 주문이 접수된 조건주문은 취소한 뒤 새로 생성하세요. 단, 취소해도 이미 접수된 주문은 취소되지 않으므로 필요하면 주문 취소 API 로 함께 취소하세요.  **Rate Limits Group**: `CONDITIONAL_ORDER` 

### Parameters

|Name | Type | Description  | Notes |
|------------- | ------------- | ------------- | -------------|
| **X-Tossinvest-Account** | **Long**| API 요청 시 사용할 계좌의 accountSeq. `GET /api/v1/accounts` 응답의 `accountSeq` 값을 사용합니다.  | [default to null] |
| **conditionalOrderId** | **String**| 조건주문 식별자 | [default to null] |
| **ConditionalOrderModifyRequest** | [**ConditionalOrderModifyRequest**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/ConditionalOrderModifyRequest.md)|  | |

### Return type

[**modifyConditionalOrder_200_response**](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/Models/modifyConditionalOrder_200_response.md)

### Authorization

[oauth2ClientCredentials](https://openapi.tossinvest.com/openapi-docs/latest/api-reference/README.md#oauth2ClientCredentials)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json