---
title: "호가 조회"
method: GET
path: "/orderbook"
tags: ["호가(Orderbook)"]
---

# 호가 조회

`GET /orderbook`

지정한 종목들의 실시간 호가(Orderbook) 정보를 조회합니다.

## Query parameters

- `markets` string, required — 조회하고자 하는 페어(거래쌍) 목록. 2개 이상의 페어에 대해 조회하고자 하는 경우 쉼표(,)로 구분된 문자열 형식으로 요청합니다. [예시] KRW-BTC,KRW-ETH,BTC-ETH,BTC-XRP
- `level` string — 호가 모아보기 단위. 원화마켓(KRW)에서만 지원하는 기능으로, 지정한 단위로 ask/bid price와 size를 모아(group) 조회할 수 있습니다. 숫자 형식의 String으로 요청합니다. 0 또는 1 이상의 모아보기 단위인 경우 소수점을 포함하지 않은 정수형 문자열로, 1 미만의 소수점 단위 모아보기 단위인 경우 double형 문자열로 요청합니다. 미지정시 기본값은 0입니다.
- `count` integer — 조회하고자 하는 호가 쌍의 개수. 최고 매수 호가 - 최저 매도 호가의 쌍을 기준으로, 지정한 개수 만큼의 호가 쌍 정보가 반환됩니다. 미지정시 기본값은 30입니다.

## Response `200`

List of orderbook

- object[]
  - `market` string, required — 페어(거래쌍)의 코드 [예시] "KRW-BTC"
  - `timestamp` integer, required — 조회 요청 시각의 타임스탬프 (ms)
  - `total_ask_size` number, double, required — 현재 호가의 전체 매도 잔량 합계
  - `total_bid_size` number, double, required — 현재 호가의 전체 매수 잔량 합계
  - `orderbook_units` object[], required — 리스트에는 호가 정보가 들어가며 차례대로 1호가, 2호가 ... 30호가의 정보를 담고 있습니다.
    - `ask_price` number, double, required — 매도 호가
    - `bid_price` number, double, required — 매수 호가
    - `ask_size` number, double, required — 매도 잔량
    - `bid_size` number, double, required — 매수 잔량
  - `level` number, double, required — 해당 호가가 적용된 가격 단위

## Other responses

- `400` — error object
- `404` — error object

---

[API](https://skmtc.net/upbit/apis/quotation-api.md) · [All operations](https://skmtc.net/upbit/apis/quotation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upbit/quotation-api/versions/b8bd8b9ed3b5/schema)