[업데이트] 주문 조회 기능 고도화 및 성능 개선

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

빗썸 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일
• 적용 대상: 아래 신규 추가 문서

유의사항

• 기존 주문 리스트 조회, 개별 주문 조회는 그대로 유지되며, 신규 엔드포인트와 필요에 따라 함께 사용하실 수 있습니다.

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

감사합니다.