---
title: "Market orderbooks"
method: GET
path: "/timeseries/market-orderbooks"
tags: ["Timeseries"]
---

# Market orderbooks

`GET /timeseries/market-orderbooks`

Returns orderbooks for specified markets.<br/> Results are ordered by tuple `(market, time)`.<br/> To fetch the next page of results use `next_page_url` JSON response field.

## Query parameters

- `markets` string[], required
- `granularity` 'raw' | '1m' | '1h' | '1d'
- `start_time` string
- `end_time` string
- `start_inclusive` boolean
- `end_inclusive` boolean
- `timezone` string
- `page_size` integer
- `depth_limit` string
- `format` string
- `paging_from` 'start' | 'end', PagingFrom
- `limit_per_market` integer
- `pretty` boolean
- `next_page_token` string

## Response `200`

Time series of market order books.

- MarketOrderbookResponse
  - `data` MarketOrderBook[], required
    - `market` string, required — Unique name of the market.
    - `time` string, required — The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `coin_metrics_id` string, required — ID of an order book or quote. It can be generated by Coin Metrics or provided by an exchange. If it is generated by Coin Metrics it is unique. If it is generated by exchange we can't guarantee its uniqueness.
    - `asks` BookEntry[], required — The ask orders on the order book.
      - `price` string, required — The limit price of the order on the order book.
      - `size` string, required — The size of the limit order on the order book in units of the base asset.
    - `bids` BookEntry[], required — The bids orders on the order book.
      - `price` string, required — The limit price of the order on the order book.
      - `size` string, required — The size of the limit order on the order book in units of the base asset.
    - `database_time` string, required — A time when we saved the data in the database. The time is in ISO 8601 date-time format. Always with nanoseconds precision.
  - `next_page_token` string — Token of the next page results for a given request.
  - `next_page_url` string — URL of the next page results for a given request.

## Other responses

- `400` — Market not found.
- `401` — Requested resource requires authorization.
- `403` — Requested resource is not available with supplied credentials.
- `414` — Provided URI is too long. It must not be greater than 10000 symbols.

---

[API](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4.md) · [All operations](https://skmtc.net/coinmetrics/apis/coin-metrics-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coinmetrics/coin-metrics-api-v4/revisions/774268c0a4fe/schema)