post
https://api.upbit.com/v1/orders/cancel_and_new
한 번의 요청으로 기존 주문을 취소하고 신규 주문을 생성합니다.
재주문 시 변경 가능 항목 및 제한 사항
- 신규 주문은 기존 주문과 동일한 페어, 동일한 주문 방향에 대해서만 생성 가능하며 변경 불가합니다.
- 선택적으로 신규 identifer(
new_identifier)를 설정할 수 있으나, 취소하고자 하는 기존 주문에 사용한 identifier 값은 재사용할 수 없습니다. - 주문 유형(
new_ord_type), 수량(new_volume), 금액(new_price), 자전거래 체결 방지 모드(new_smp_type), 주문 체결 옵션(new_time_in_force)은 변경할 수 있습니다. - 기존 주문이 부분 체결 주문인 경우 수량(new_volume) 파라미터에 "remain_only"를 요청하여 신규 주문 수량을 기존 주문 잔량으로 쉽게 지정할 수 있습니다.
신규 주문 유형에 따른 필수 파라미터
신규 주문 유형(new_ord_type)에 따른 필수 파라미터는 다음과 같습니다.
| 주문 유형 | 필수 필드 | |
|---|---|---|
| 지정가(limit) | new_volume, new_price | |
| 시장가 매수(price) | new_price | |
| 시장가 매도(market) | new_volume | |
| 최유리 지정가(best) 매수 | new_price, new_time_in_force | |
| 최유리 지정가(best) 매도 | new_volume, new_time_in_force |
자세한 주문 유형 별 파라미터 예시는 주문 생성 문서를 참고해주시기 바랍니다.
신규 주문 생성 조건
본 API 요청시 신규 주문은 반드시 이전 주문의 취소가 완료된 이후 생성됩니다. API가 성공적으로 요청되더라도, 기존 주문의 취소 처리가 완료되기 전에 전량 체결되어 취소가 불가능한 경우 신규 주문은 생성되지 않습니다.
취소 요청 시 prev_order_uuid 또는 prev_order_identifier를 반드시 포함해야 합니다.
두 파라미터 모두 선택(Optional) 파라미터이지만, 취소 대상 주문 지정을 위해 반드시 하나의 파라미터를 포함해야 합니다.
POST API에 대한 Form 방식 요청은 2022년 3월 1일부로 지원이 종료되었습니다.
Form 방식 지원 종료에 따라 Urlencoded Form 방식으로 전송하는 POST 요청에 대한 정상적인 동작을 보장하지 않습니다. 반드시 JSON 형식으로 요청 본문(Body)을 전송해주시기 바랍니다.
| 반영 버전 | 반영 일자 | 변경 사항 |
|---|---|---|
| v1.5.8 | 2025-07-02 | Post Only 주문 옵션 신규 지원 |
| v1.5.8 | 2025-07-02 | 자전거래 체결 방지(SMP) 기능 신규 지원에 따른 필드 추가 smp_type,prevented_volume,prevented_locked |
| 2025-02-05 | "취소 후 재주문" API 신규 지원 |
Rate Limit
초당 최대 8회 호출할 수 있습니다. 포켓 단위로 측정되며 [주문 생성 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.
API Key Permission
인증이 필요한 API로, [주문하기] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.