※ 2026년 3월 12일: 기능 및 문서 적용이 완료되었습니다.

※ 2026년 3월 4일: 웹소켓 업데이트 영향 관련 안내가 추가되었습니다.

안녕하세요. 당신의 안전한 금융 파트너, 빗썸입니다.

빗썸 Open API를 이용하시는 회원님들께 보다 최적화된 거래 환경을 제공하고자,

사용자 정의 식별 ID(client_order_id) 도입 및 다건(Batch) 주문 기능을 새롭게 선보일 예정입니다.

이번 업데이트를 통해 회원님이 직접 부여한 고유 ID로 주문을 관리하고, 여러 건의 주문을 동시에 처리할 수 있게 됩니다.

상세 내용을 확인하시어 서비스 이용에 참고하시기 바랍니다.

📌
웹소켓(MyOrder) 업데이트 적용 과정에서 일시적으로 연결이 끊어질 수 있으며, 해당 구간 동안 실시간 데이터 수신이 지연될 수 있습니다. 이용에 참고 부탁드립니다.

주문 시 회원님이 직접 고유한 식별 ID를 부여할 수 있는 client_order_id 기능이 신규 도입됩니다. 이를 통해 서버에서 부여하는 주문 번호(order_id)와 별개로, 클라이언트 측에서 주문을 식별하거나 중복 주문을 방지할 수 있습니다.

주문하기 (POST /v2/orders)
- 요청(Request) 데이터에 회원님이 직접 부여할 수 있는 client_order_id가 포함됩니다. (POST /v2/orders 한정)
- 응답(Response) 데이터에 회원님이 부여한 client_order_id가 포함됩니다.

주문 취소 접수 (DELETE /v1/order, POST /v2/orders/cancel)
- 요청 시 order_id 또는 client_order_id 중 하나 이상이 반드시 전달되어야 하며, 두 값이 모두 전달된 경우 order_id를 기준으로 취소 처리가 진행됩니다. (POST /v2/orders/cancel 한정)
- 응답(Response) 데이터에 회원님이 부여한 client_order_id가 포함됩니다.

개별 주문 조회 (GET /v1/order)
- uuid 또는 client_order_id 중 하나 이상을 반드시 전달해야 하며, 두 값이 모두 전달된 경우 uuid를 기준으로 조회합니다.

주문 리스트 조회 (GET /v1/orders)
- uuids 또는 client_order_ids 중 하나 이상을 반드시 전달해야 하며, 두 값이 모두 전달된 경우 uuids를 기준으로 조회합니다.

대상 : MyOrder (내 주문 및 체결)
설명: 실시간 주문 및 체결 상태를 전달하는 웹소켓 응답 데이터에 사용자 정의 식별 ID 필드인 client_order_id(축약어 : coid)가 추가됩니다.

한 번의 API 호출로 여러 건의 주문을 처리할 수 있는 다건(Batch) 전용 엔드포인트가 추가됩니다.

엔드포인트: POST /v2/orders/cancel
설명: 여러 건의 주문을 한 번에 취소 요청할 수 있습니다. 요청 시 order_ids 또는 client_order_ids 중 하나 이상이 반드시 전달되어야 하며, 두 값이 모두 전달된 경우 order_ids를 기준으로 취소 처리가 진행됩니다.

※ 배포 상황에 따라 일정이 변경될 수 있습니다.

빗썸은 회원님의 편리하고 안전한 거래를 위해 항상 노력하겠습니다.

감사합니다.