get
https://api.upbit.com/v1/orderbook
지정한 종목들의 실시간 호가(Orderbook) 정보를 조회합니다.
호가 모아보기 (level)
원화마켓(KRW)에서만 지원하는 기능으로, 지정한 단위로 ask/bid price와 size를 모아(group) 조회할 수 있습니다. 숫자 형식의 String으로 요청합니다.
[예시]: KRW-BTC 종목에 대해 level=100000으로 요청시 10만원(KRW) 단위로 ask/bid price가 반환되며, 각 금액대 내에 포진된 매수/매도 주문량의 합산이 size로 반환됩니다.
종목별 호가 단위에 따라 지원하는 모아보기 단위가 다릅니다. 지원하는 모아보기 단위 정보는 마켓별 주문 정책 문서 또는 호가 정책 조회 API 응답을 참고하여 사용해주시기 바랍니다. 미지원 단위를 지정하여 요청하는 경우 빈 배열이 반환되므로 호출 전 지원하는 단위를 반드시 확인해주시기 바랍니다.
| 반영 버전 | 반영 일자 | 변경 사항 |
|---|---|---|
| v1.5.8 | 2025-07-02 | count 파라미터 신규 지원, 최대 30호가 지원 |
| v1.4.4 | 2024-01-22 | 호가 모아보기 기능 신규 지원(원화 마켓) |
Rate Limit
초당 최대 10회 호출할 수 있습니다. IP 단위로 측정되며 [호가 그룹] 내에서 요청 가능 횟수를 공유합니다.