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

# 호가(Orderbook) 조회

`GET /orderbook`

지정한 거래 페어의 호가 정보를 조회합니다.

## Query parameters

- `markets` string, required

## Response `200`

200

- object[]
  - `market` string — 거래 대상 페어의 고유 심볼 예시) KRW-BTC
  - `timestamp` string, int64 — 호가 정보 생성 시각(Unix timestamp, Unit: ms)
  - `total_ask_size` number, double — 호가 매도 총 잔량
  - `total_bid_size` number, double — 호가 매수 총 잔량
  - `orderbook_units` object[] — 호가 리스트. 1호가부터 순차적으로 호가 정보를 제공합니다. `markets` 파라미터에 복수의 항목을 입력하면 15호가까지, 하나의 항목만 입력하면 30호가까지 제공
    - `ask_price` number, double — 매도 호가
    - `bid_price` number, double — 매수 호가
    - `ask_size` number, double — 매도 잔량
    - `bid_size` number, double — 매수 잔량

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/bithumb/apis/open-api-public.md) · [All operations](https://skmtc.dev/bithumb/apis/open-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bithumb/open-api-public/revisions/9edc2d6e86db/schema)