---
title: "Get orderbook depth"
method: GET
path: "/api/v1/orderbook"
tags: ["Market Data"]
---

# Get orderbook depth

`GET /api/v1/orderbook`

Returns bid/ask depth (50 levels each side) for a given ticker_id,
per the CoinGecko/CMC derivatives endpoint spec.

## Query parameters

- `ticker_id` string, required

## Response `200`

Orderbook depth

- OrderbookResponse — CoinGecko/CMC orderbook response with bid/ask depth. Prices and quantities are string pairs per the aggregator spec.
  - `asks` array[], required — Ask levels as [price, quantity] string pairs, lowest price first
    - string[]
  - `bids` array[], required — Bid levels as [price, quantity] string pairs, highest price first
    - string[]
  - `ticker_id` string, required
  - `timestamp` string, required — Unix timestamp in milliseconds of last update

## Other responses

- `400` — Invalid ticker_id
- `404` — Market not found
- `500` — Database error

---

[API](https://skmtc.net/decibel/apis/decibel-trading-api.md) · [All operations](https://skmtc.net/decibel/apis/decibel-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decibel/decibel-trading-api/revisions/37a02083ff59/schema)