added

[안내] 호가 정보 조회 API count 파라미터 추가 (완료)

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]으로 연락해 주시기 바랍니다.

항상 더 나은 서비스를 제공하기 위해 노력하겠습니다.

감사합니다.

업비트 개발자센터 드림