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

# 주문 일괄 취소 접수

`DELETE /v1/orders/open`

## Request

- Base URL: `https://api.upbit.com`
- URL: `https://api.upbit.com/v1/orders/open`
- Auth: none declared

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

## Query parameters

- `quote_currencies` string: 주문 취소 대상 마켓 목록. 디지털 자산 구매에 사용되는 통화(KRW,BTC,USDT)로 취소 대상 주문을 한정할 수 있는 필터 파라미터입니다. [예시] "KRW"로 지정시 원화마켓의 모든 미체결 주문 취소
- `cancel_side` 'bid' | 'ask' | 'all': 취소하고자 하는 주문의 매수/매도 방향 구분. 사용 가능한 값은 "all"(전체), "ask"(매도), "bid"(매수)입니다.
- `count` integer: 취소할 주문의 최대 개수. 최대값은 300이며 미지정시 기본값은 20입니다.
- `order_by` 'asc' | 'desc': 취소할 주문의 정렬 방식. "desc"(최신 주문 순) 또는 "asc"(오래된 주문 순). 기본값은 "desc"입니다.
- `pairs` string: 페어(거래쌍) 목록. 지정한 페어의 미체결 주문만 취소합니다. 최대 20개, 쉼표(,)로 구분합니다. [예시] pairs=KRW-BTC,KRW-ETH
- `excluded_pairs` string: 제외할 페어(거래쌍) 목록. 지정한 페어의 주문을 제외한 모든 주문을 취소합니다. 최대 20개, 쉼표(,)로 구분합니다. [예시] excluded_pairs=KRW-BTC,KRW-ETH

## Response `200`

Object of batch cancellation result

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

## Other responses

- `400`: error object
- `401`: error object
- `404`: error object

---

[API](https://skmtc.dev/upbit/apis/exchange-api.md) - [All operations](https://skmtc.dev/upbit/apis/exchange-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/exchange-api/revisions/150ea50e351c?raw)