주문 일괄 취소 접수

일괄 취소 API로는 오직 체결 대기(WAIT) 상태의 주문만 취소할 수 있습니다. 단, 취소 처리 중 주문 체결이 발생할 수 있으므로 취소요청을 보내는 시점의 주문 잔량과 일괄 취소가 완료된 후 취소된 주문의 주문 잔량은 다를 수 있습니다.

예약 주문(WATCH) 상태의 주문은 일괄 주문 취소로 취소할 수 없으므로 취소를 원하시는 경우 개별 주문 취소 접수 또는 id로 주문 목록 취소 접수 API를 사용해주세요.

일괄 취소 대상 주문을 지정하기 위해 다음 조건들을 사용할 수 있습니다.

취소 대상 페어 또는 대상 마켓에 포함된 페어 중 취소 제외 페어(excluded_pairs)에 포함된 페어의 경우, 취소 제외 페어 지정을 높은 우선순위로 적용하여 취소 대상에서 제외됩니다.

주문 취소 요청이 거절되는 경우

다음과 같은 사유로 주문 취소 요청이 거절될 수 있습니다.

이미 전량 체결 완료되어 취소가 불가한 주문

이미 취소가 완료된 주문

해당 주문의 페어가 리브랜딩 등의 이유로 서비스를 일시 정지한 경우

이 API는 쿼리 파라미터 형식만 지원합니다.

모든 요청 파라미터는 쿼리 파라미터 형식으로만 요청할 수 있습니다. Request Body를 통한 form 형식 또는 json 형식의 파라미터 요청을 지원하지 않습니다.

[예시] /v1/orders/open?cancel_side=bid

페어(pairs)과 마켓(quote_currencies) 조건은 동시에 사용할 수 없습니다.

둘 중 최대 하나의 파라미터만 포함할 수 있으며, 두 파라미터 모두 지정하지 않는 경우 전체 마켓을 대상으로 일괄 취소 주문이 선택됩니다.

Revision History

반영 버전	반영 일자	변경 사항
-	2024-12-11	'주문 일괄 취소' 기능 신규 지원

Rate Limit

최대 2 초당 1회 호출할 수 있습니다.

API Key Permission

인증이 필요한 API로, [주문하기] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.