---
search:
  tags:
    - Markets
    - GET
seo:
  description: >-
    Returns the current aggregated order book (price levels) for a market,
    priced… Reference for the GET /markets/{ticker}/orderbook endpoint in the
    REST API API.
sidebar:
  badge: GET
  label: Get a Market's Order Book
title: Get a Market's Order Book
type: openapi-operation
---
Returns the current aggregated order book (price levels) for a market, priced from the YES side.

### Endpoint

- Method and path: `GET /markets/{ticker}/orderbook`
- Operation ID: `getMarketOrderbook`
- API reference: [GET /markets/{ticker}/orderbook](/api-reference/markets/getmarketorderbook)

#### Authorization

- Credential: none
- Details: [Authentication](/authentication)

#### Parameters

- `UDX-Version` (`header`) — Dated API version (YYYY-MM-DD). Omit to use the oldest supported version. An unknown version returns `400`.
- `ticker` (`path`, required) — The market's ticker.
- `depth` (`query`) — Maximum number of price levels to return per side.

#### Responses

- `200` — The market's aggregated order book.
- `404` — The requested resource doesn't exist or isn't visible to the caller.
- `429` — The public request rate was exceeded. Wait for `Retry-After`.
- `500` — Something went wrong on UDX's side.
- `503` — Request admission is unavailable. Retry later.