---
title: "Historical data"
method: GET
path: "/v1/quotes/{symbol_id}/history"
tags: ["Quotes"]
---

# Historical data

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

## Request

- Base URL: `https://rest.coinapi.io`
- URL: `https://rest.coinapi.io/v1/quotes/{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/quotes/:symbol_id/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Get historical quote updates within requested time range, returned in time ascending order.
            
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

## Response `200`

successful operation

- V1Quote[]
  - `symbol_id` string, nullable: Gets or sets the symbol identifier.
  - `time_exchange` string, date-time: Gets or sets the exchange time of the quote.
  - `time_coinapi` string, date-time: Gets or sets the CoinAPI time when the quote was received.
  - `ask_price` number, double, nullable: Gets or sets the best asking price.
  - `ask_size` number, double, nullable: Gets or sets the volume resting on the best ask. If the value is equal to zero, then the size is unknown.
  - `bid_price` number, double, nullable: Gets or sets the best bidding price.
  - `bid_size` number, double, nullable: Gets or sets the volume resting on the best bid. If the value is equal to zero, then the size is 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)