---
title: "Historical data"
method: GET
path: "/v1/orderbooks/{symbol_id}/history"
tags: ["Order Book"]
---

# Historical data

`GET /v1/orderbooks/{symbol_id}/history`

## Request

- Base URL: `https://rest.coinapi.io`
- URL: `https://rest.coinapi.io/v1/orderbooks/{symbol_id}/history`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/docs/v1/orderbooks/:symbol_id/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Get historical order book snapshots for a specific symbol within time range, returned in time ascending order.
            
:::info
The historical order book data via the REST API is currently limited by a number of updates and to the maximum number of 50 levels.
:::
            
This endpoint supports hourly granularity for APITP data with automatic fallback to daily data for older records.
Timestamps are normalized to hour boundaries, and data is fetched per hour with precise filtering to your exact time range.
            
:::tip
For querying a full day of data, use the 'date' parameter. For specific time ranges (including cross-day or multi-hour queries), use 'time_start' and 'time_end'.
:::

## Path parameters

- `symbol_id` string, required

## Query parameters

- `date` string
- `time_start` string
- `time_end` string
- `limit` integer
- `limit_levels` integer

## Response `200`

successful operation

- V1OrderBook[]
  - `symbol_id` string, nullable: Gets or sets the symbol identifier.
  - `time_exchange` string, date-time: Gets or sets the exchange time of the order book.
  - `time_coinapi` string, date-time: Gets or sets the CoinAPI time when the order book was received.
  - `asks` unknown
  - `bids` unknown

---

[API](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api.md) - [All operations](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/revisions/8e2d7b7d9f23?raw)