---
title: "Get orderbook levels"
method: GET
path: "/v1/orderbook"
tags: ["Markets"]
---

# Get orderbook levels

`GET /v1/orderbook`

Get orderbook price levels for a specific market. Returns aggregated bid/ask levels sorted by price.

## Query parameters

- `market_id` string, int64, required
- `limit` integer

## Response `200`

A successful response.

- ApiGetOrderbookLevelsResponse — Response for GetOrderbookLevels - returns aggregated orderbook price levels.
  - `market_id` string, int64 — Market ID.
  - `bids` GetOrderbookLevelsResponsePriceLevel[] — Bid price levels (sorted descending by price - highest first).
    - `price` string — Price at this level (decimal string, 18 decimals).
    - `quantity` string — Total quantity at this level (decimal string, 18 decimals).
    - `order_count` integer — Number of orders at this level.
  - `asks` GetOrderbookLevelsResponsePriceLevel[] — Ask price levels (sorted ascending by price - lowest first).
    - `price` string — Price at this level (decimal string, 18 decimals).
    - `quantity` string — Total quantity at this level (decimal string, 18 decimals).
    - `order_count` integer — Number of orders at this level.
  - `total_bids` string, int64 — Total number of bid price levels (before limit applied).
  - `total_asks` string, int64 — Total number of ask price levels (before limit applied).

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/revisions/194af8339c0d/schema)