---
title: "주문 일괄 취소 접수"
method: DELETE
path: "/orders/open"
tags: ["주문(Order)"]
---

# 주문 일괄 취소 접수

`DELETE /orders/open`

조건을 지정하여 해당 조건을 만족하는 최대 300개의 주문을 일괄 취소합니다.

## Query parameters

- `quote_currencies` string — 주문 취소 대상 마켓 목록. 디지털 자산 구매에 사용되는 통화(KRW,BTC,USDT)로 취소 대상 주문을 한정할 수 있는 필터 파라미터입니다. 지정한 마켓에 속한 미체결 주문을 일괄 취소합니다. [예시] “KRW”로 지정시 원화마켓의 모든 미체결 매수 주문 취소
- `cancel_side` 'bid' | 'ask' | 'all' — 취소하고자 하는 주문의 매수/매도 방향 구분. 매수/매도 구분으로 취소 대상을 한정할 수 있는 필터 파라미터입니다. 사용 가능한 값은 “all”(매수, 매도 전체), “ask”(매도), “bid”(매수)입니다. [예시] “ask”로 설정시 체결 대기중인 매도 주문을 일괄 취소합니다.
- `count` integer — 취소할 주문의 최대 개수. 필터 파라미터들의 조합으로 한정된 대상 주문의 수가 count보다 많은 경우, 정렬 기준에 따라 count에 설정된 수만큼의 주문만 취소합니다. 최대값은 300이며 미지정시 기본값은 20입니다.
- `order_by` 'asc' | 'desc' — 취소할 주문의 정렬 방식. 주문 생성 시각을 기준으로 설정한 방식에 따라 정렬된 주문 순서에 따라 count개 주문에 대해 취소를 요청합니다. 사용 가능한 값은 “desc”(내림차순, 최신 주문 순) 또는 “asc”(오름차순, 오래된 주문 순)입니다. 기본값은 “desc”입니다.
- `pairs` string — 페어(거래쌍) 목록. 주문 페어로 취소 대상을 한정할 수 있는 필터 파라미터입니다. 지정한 페어의 미체결 주문만 취소합니다. 최대 20개의 페어를 지정할 수 있으며, 2개 이상의 페어 지정시 쉼표(,)로 구분된 문자열 형식을 사용합니다. [예시] pairs=KRW-BTC,KRW-ETH
- `exclude_pairs` string — 페어(거래쌍) 목록. 특정 페어를 제외한 모든 페어를 취소 대상 주문을 한정할 수 있는 필터 파라미터입니다. 지정한 페어의 주문을 제외한 모든 주문을 취소합니다. 최대 20개의 페어를 지정할 수 있으며, 2개 이상의 페어 지정시 쉼표(,)로 구분된 문자열 형식을 사용합니다. [예시] pairs=KRW-BTC,KRW-ETH

## Response `200`

Object of batch cancellation result

- object
  - `success` object, required — 성공적으로 취소된 주문 정보
    - `count` number, required — 성공적으로 취소된 주문 수
    - `orders` object[], required — 성공적으로 취소된 주문 목록
      - `uuid` string, required — 주문의 유일 식별자
      - `market` string, required — 페어(거래쌍)의 코드 [예시] "KRW-BTC"
      - `identifier` string — 주문 생성시 클라이언트가 지정한 주문 식별자. * identifier 필드는 2024년 10월 18일 이후 생성된 주문에 대해서만 제공됩니다.
  - `failed` object, required — 취소 실패한 주문 정보
    - `count` number, required — 취소 실패한 주문 수
    - `orders` object[], required — 취소 실패한 주문 목록
      - `uuid` string, required — 주문의 유일 식별자
      - `market` string, required — 페어(거래쌍)의 코드 [예시] "KRW-BTC"
      - `identifier` string — 주문 생성시 클라이언트가 지정한 주문 식별자. * identifier 필드는 2024년 10월 18일 이후 생성된 주문에 대해서만 제공됩니다.

## Other responses

- `400` — error object
- `401` — error object
- `404` — error object

---

[API](https://skmtc.net/upbit/apis/quotation-api.md) · [All operations](https://skmtc.net/upbit/apis/quotation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upbit/quotation-api/versions/b8bd8b9ed3b5/schema)
