delete
https://api.upbit.com/v1/orders/open
조건을 지정하여 해당 조건을 만족하는 최대 300개의 주문을 일괄 취소합니다.
주문 상태에 따른 일괄 취소 가능 여부
일괄 취소 API로는 오직 체결 대기(WAIT) 상태의 주문만 취소할 수 있습니다. 단, 취소 처리 중 주문 체결이 발생할 수 있으므로 취소요청을 보내는 시점의 주문 잔량과 일괄 취소가 완료된 후 취소된 주문의 주문 잔량은 다를 수 있습니다.
예약 주문(WATCH) 상태의 주문은 일괄 주문 취소로 취소할 수 없으므로 취소를 원하시는 경우 개별 주문 취소 접수 또는 id로 주문 목록 취소 접수 API를 사용해주세요.
취소 대상 지정
일괄 취소 대상 주문을 지정하기 위해 다음 조건들을 사용할 수 있습니다.
- 주문 방향: 매수 또는 매도 주문만 선택적으로 취소할 수 있습니다.
- 페어: 최대 20개의 취소 대상 페어를 지정하거나, 취소 제외 페어를 지정할 수 있습니다.
- 마켓(호가 자산): 특정 마켓의 주문만 일괄 취소할 수 있습니다.
- 취소 주문 수와 정렬 옵션: 최신 순 또는 오래된 순으로 지정한 수 만큼의 주문을 일괄 취소할 수 있습니다.
취소 대상 페어 또는 대상 마켓에 포함된 페어 중 취소 제외 페어(excluded_pairs)에 포함된 페어의 경우, 취소 제외 페어 지정을 높은 우선순위로 적용하여 취소 대상에서 제외됩니다.
주문 취소 요청이 거절되는 경우
다음과 같은 사유로 주문 취소 요청이 거절될 수 있습니다.
이 API는 쿼리 파라미터 형식만 지원합니다.
모든 요청 파라미터는 쿼리 파라미터 형식으로만 요청할 수 있습니다. Request Body를 통한 form 형식 또는 json 형식의 파라미터 요청을 지원하지 않습니다.
[예시] /v1/orders/open?cancel_side=bid
페어(pairs)과 마켓(quote_currencies) 조건은 동시에 사용할 수 없습니다.
둘 중 최대 하나의 파라미터만 포함할 수 있으며, 두 파라미터 모두 지정하지 않는 경우 전체 마켓을 대상으로 일괄 취소 주문이 선택됩니다.
| 반영 버전 | 반영 일자 | 변경 사항 |
|---|---|---|
| - | 2024-12-11 | '주문 일괄 취소' 기능 신규 지원 |
Rate Limit
최대 2 초당 1회 호출할 수 있습니다. 포켓 단위로 측정되며[Exchange 주문 일괄 취소 그룹]내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.
API Key Permission
인증이 필요한 API로, [주문하기] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.