UPupbit
Quotation

Get Orderbook

Changed on

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

get/v1/orderbook

Request

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

Query parameters

marketsstring required

List of trading pairs to query.

For multiple pairs, use comma-separated format.

Example:SGD-BTC,SGD-ETH
countinteger

Number of orderbook entries to retrieve.

Based on the best bid-ask pair, returns the specified number of pairs. Default: 30.

Example:10

Response

List of orderbook

marketstring required

Trading pair code.

timestampinteger required

Timestamp of the query request (ms).

total_ask_sizenumber double required

Total ask volume in the current orderbook.

total_bid_sizenumber double required

Total bid volume in the current orderbook.

levelnumber double required

Price unit applied for this orderbook level.

Example response

[
  {
    "market": "SGD-BTC",
    "timestamp": 1750749886904,
    "total_ask_size": 10.64580882,
    "total_bid_size": 8.26105616,
    "orderbook_units": [
      {
        "ask_price": 146030000,
        "bid_price": 146000000,
        "ask_size": 0.74547181,
        "bid_size": 0.20338834
      }
    ],
    "level": 10000
  }
]

Changes