added
[안내] 호가 정보 조회 API count 파라미터 추가 (완료)
24 days ago
REST 호가정보조회 OrderBook count
안녕하세요, 업비트 개발자센터입니다.
호가 정보 조회 (GET /v1/orderbook) API에 새로운 요청 파라미터 count가 추가되어 안내드립니다.
호가 정보 조회(v1/orderbook) 파라미터 추가
count 파라미터를 통해 조회할 수 있는 호가 정보 범위(1호가, 2호가 … 30호가)를 직접 지정할 수 있습니다.
최대 15호가의 depth만 제공되던 제한이 완화되어, 최대 30호가까지 조회가 가능합니다.
→ 30호가 확대 공지
| 항목 | 내용 |
|---|---|
| 파라미터명 | count |
| 타입 | Integer |
| 필수 여부 | 선택 (Optional) |
| 기본값 | 30 |
| 허용 범위 | 1 ~ 30 |
| 설명 | 반환받을 매수/매도 호가 개수를 지정합니다. |
| 예시 요청 | /v1/orderbook?markets=KRW-BTC&count=10 |
| 동작 방식 | 지정한 수만큼의 호가 레벨(매수/매도 가격 구간)이 JSON 응답에 포함됩니다. |
| 예외 처리 | 범위를 벗어난 값(count < 1 또는 count >30) 입력 시 기본값 적용됩니다. |
일정
- 배포일 : 2025년 7월 2일(수)
- 적용 API 문서 버전 :
v 1.5.8이상
문의 사항이 있으실 경우, [email protected]으로 연락해 주시기 바랍니다.
항상 더 나은 서비스를 제공하기 위해 노력하겠습니다.
감사합니다.
업비트 개발자센터 드림