---
title: "다건 주문 취소 접수"
method: POST
path: "/orders/cancel"
---

# 다건 주문 취소 접수

`POST /orders/cancel`

여러 개의 주문을 일괄 취소 요청합니다. 요청당 최대 30건까지 처리할 수 있습니다.

## Headers

- `Authorization` string, required

## Request body

- object
  - `order_ids` string[] — 취소할 주문의 고유 ID(구 `uuid`) 목록(max 30)
  - `client_order_ids` string[] — 서버에서 부여하는 주문 ID(구 `uuid`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID 목록(max 30) - 허용 문자: 영문 대/소문자, 숫자, -, _ - 길이: 1–36자

## Response `200`

200

- object
  - `success` object[], required — 주문 취소 성공 목록
    - `order_id` string — 주문의 고유 ID(구 `uuid`)
    - `client_order_id` string — 서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정한 고유 ID. 해당 주문에 `client_order_id` 존재하는 경우 반환
    - `created_at` string, date-time — 주문 취소 요청 시각
  - `fail` object[], required — 주문 취소 실패 목록
    - `order_id` string — 주문의 고유 ID(구 `uuid`). `client_order_id`로 조회했으나 매칭되는 주문이 없는 경우 반환되지 않을 수 있음.
    - `client_order_id` string — 서버에서 부여하는 주문 ID(`order_id`)와 별도로 주문 생성 시 사용자가 직접 지정하는 고유 ID
    - `error` object
      - `name` string — 에러명
      - `message` string — 에러 메시지

## Other responses

- `400` — Result
- `422` — 422

---

[API](https://skmtc.dev/bithumb/apis/open-api-public.md) · [All operations](https://skmtc.dev/bithumb/apis/open-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bithumb/open-api-public/revisions/9edc2d6e86db/schema)