---
title: "Get Orderbook"
method: GET
path: "/v1/orderbook"
tags: ["Quotation"]
---

# Get Orderbook

`GET /v1/orderbook`

## Request

- Base URL: `https://{region}-api.upbit.com`
- URL: `https://{region}-api.upbit.com/v1/orderbook`
- Auth: none declared

Retrieves the real-time orderbook data for the specified markets.

## Query parameters

- `markets` string, required: List of trading pairs to query. For multiple pairs, use comma-separated format.
- `count` integer: Number of orderbook entries to retrieve. Based on the best bid-ask pair, returns the specified number of pairs. Default: 30.

## Response `200`

List of orderbook

- Orderbook[]
  - `market` string, required: Trading pair code.
  - `timestamp` integer, required: Timestamp of the query request (ms).
  - `total_ask_size` number, double, required: Total ask volume in the current orderbook.
  - `total_bid_size` number, double, required: Total bid volume in the current orderbook.
  - `orderbook_units` object[], required: List of orderbook entries ordered from level 1 to level 30.
    - `ask_price` number, double, required: Lowest sell (ask) price.
    - `bid_price` number, double, required: Highest buy (bid) price.
    - `ask_size` number, double, required: Sell quantity at ask price.
    - `bid_size` number, double, required: Buy quantity at bid price.
  - `level` number, double, required: Price unit applied for this orderbook level.

## Other responses

- `400`: error object
- `404`: error object

## Changes

- **2026-11-03** `b16d646563b9`: 1 warning
  - deleted the `query` request parameter `level`
- **2026-11-03** `dd023742548b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/upbit/apis/quotation-api/changes/v1/orderbook/get.md)

---

[API](https://skmtc.dev/upbit/apis/quotation-api.md) - [All operations](https://skmtc.dev/upbit/apis/quotation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/quotation-api/revisions/b16d646563b9?raw)