[공지] Open API 신규 기능 도입 예정 안내 (사용자 정의 식별 ID 및 다건 주문)

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

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

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

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

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

■ 변경사항

1 . [신규 기능] 사용자 정의 식별 ID (client_order_id) 도입

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

1) 주문 및 취소 시 식별 ID 지원 (REST API)

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

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

2) 식별 ID를 활용한 주문 조회 (REST API)

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

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

3) 웹소켓 응답 데이터 내 식별 ID 추가 (WebSocket)

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

2. [신규 엔드포인트] 다건(Batch) 주문 및 취소 기능

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

1) 다건 주문하기

• 엔드포인트: POST /v2/orders/batch
• 설명: 한 번에 여러건의 주문을 일괄 접수할 수 있습니다 . 각 주문별로 client_order_id를 추가하여 관리할 수 있습니다.

2 ) 다건 주문 취소 접수

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

■ 적용 일정: 2026년 3월 12일 오후 4시

■ 적용 버전 : v2.1.0, v2.1.5

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

감사합니다.