안녕하세요. 당신의 안전한 금융 파트너, 빗썸입니다. 빗썸 Open API를 이용하시는 회원님께 더 편리하고 빠른 주문 조회 환경을 제공하기 위해 신규 조회 엔드포인트 3종을 추가했습니다. 기존에는 주문 리스트 조회 하나로 다양한 조건의 주문 목록을 조회했지만, 이번 업데이트로 다건 주문 조회, 대기 주문 조회, 종료 주문 조회로 목적별로 분리하고 조회 성능을 전반적으로 개선했습니다. ### ■ 주요 변경 사항 이번 업데이트로 신규 추가된 엔드포인트입니다. - 다건 주문 조회 신규 추가 - 대기 주문 목록 조회 신규 추가 - 종료 주문 목록 조회 신규 추가 ### ■ 변경 내용 상세 **1. 다건 주문 조회 (POST /v2/orders/search)** 주문 ID 목록으로 최대 100건의 주문을 한 번의 요청으로 조회합니다. - 한 번에 최대 100건 조회 (`order_ids` 또는 `client_order_ids`) - API 호출 횟수 최대 1/100 수준으로 감소, Rate Limit 여유 확보 - 사용자가 지정한 `client_order_id`로도 직접 조회 가능 **2. 대기 주문 목록 조회 (GET /v2/orders/pending)** 체결 대기(`wait`) 또는 예약 주문 대기(`watch`) 상태의 주문 목록을 조회합니다. - 페이지당 최대 100건 조회 - `next_key` 기반 커서 페이지네이션 지원 **3. 종료 주문 목록 조회 (GET /v2/orders/history)** 처리 완료(`done`) 또는 취소(`cancel`)된 주문 목록을 조회합니다. 기간 검색과 다중 상태 필터를 지원합니다. - 페이지당 최대 1,000건 조회 - 조회 기간 최대 7일, `start_time` / `end_time`으로 기간 지정 - `state` 단건 또는 `states[]` 복수 상태 필터 지원 - `next_key` 기반 커서 페이지네이션 지원 ### ■ 적용 일시 및 대상 - 적용 일시: 2026년 7월 9일 - 적용 대상: 아래 신규 추가 문서 | 버전 | 문서 | | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | v2.1.5 | 다건 주문 조회, 대기 주문 목록 조회, 종료 주문 목록 조회 | ### ■ 유의사항 - 기존 주문 리스트 조회, 개별 주문 조회는 그대로 유지되며, 신규 엔드포인트와 필요에 따라 함께 사용하실 수 있습니다. 앞으로도 빗썸은 회원님의 편리하고 안전한 거래를 위해 노력하겠습니다. 감사합니다.