---
title: "Get market orderbook"
method: GET
path: "/orderbook/{market}"
tags: ["Markets"]
---

# Get market orderbook

`GET /orderbook/{market}`

Get snapshot of the orderbook for the given market

## Path parameters

- `market` string, required

## Query parameters

- `depth` integer
- `price_tick` string

## Response `200`

OK

- ResponsesAskBidArray
  - `asks` array[] — List of Ask sizes and prices
    - string[]
  - `best_ask_api` string[] — Size on the best ask from API (excluding RPI)
  - `best_ask_interactive` string[] — Size on the best ask from UI
  - `best_bid_api` string[] — Size on the best bid from API (excluding RPI)
  - `best_bid_interactive` string[] — Size on the best bid from UI
  - `bids` array[] — List of Bid sizes and prices
    - string[]
  - `last_updated_at` integer — Last update to the orderbook in milliseconds
  - `market` string — Market name
  - `seq_no` integer — Sequence number of the orderbook

## Other responses

- `400` — Bad Request

## Changes

- **2026-09-24** `c8ee50dffebb` — 1 warning
  - added the new `MMP_MIN_FREEZE_NOT_ELAPSED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- **2026-09-22** `250909706663` — 4 warning
  - added the new `MMP_CONFIG_INVALID` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `MMP_NOT_CONFIGURED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `MMP_NOT_ENABLED` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - added the new `PORTFOLIO_MARGIN_CONFIG_NOT_FOUND` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- **2026-09-20** `ed3abd15a2eb` — 1 warning, 1 info
  - added the new `MARGIN_CONFIG_NOT_FOUND` enum value to the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
  - removed the `PORTFOLIO_MARGIN_CONFIG_NOT_FOUND` enum value from the `error/allOf[#/components/schemas/responses.ErrorCode]/` response property for the response status `400`
- …earlier changes not shown

[Full history](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/changes/orderbook/:market/get.md)

---

[API](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tradeparadex/apis/paradex-rest-api-2/revisions/b6e4b952f10a?raw)