---
title: "Get historical OHLC"
method: GET
path: "/coins/{coin_id}/ohlcv/historical"
tags: ["Coins"]
---

# Get historical OHLC

`GET /coins/{coin_id}/ohlcv/historical`

## Request

- Base URL: `https://api.coinpaprika.com/v1`
- URL: `https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical`
- Auth: none required
- TypeScript: <https://skmtc.dev/coinpaprika/apis/coinpaprika-api/docs/coins/:coin_id/ohlcv/historical/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns Open/High/Low/Close values with volume and market capitalization for any date range. If the `end` date is the current day, data can change with every request until actual close of the day at 23:59:59.

Candles are built from our aggregated volume-weighted price rather than one exchange's tape. Before comparing a long range against another source, read the [price calculation methodology](https://coinpaprika.com/methodology), in particular its algorithm history, which records the changes that affect how older candles compare with recent ones.

On Business, Ultimate and Enterprise plans each entry also includes `circulating_supply`: the circulating supply implied by the entry, calculated as `market_cap / close` in USD (an approximation, not a recorded supply value). The field is omitted on other plans and when market cap or price is missing.

**Available on the following API plans:**
- Free
- Starter
- Pro
- Business
- Ultimate
- Enterprise

**Maximum time range of data available to fetch depending on the plan:**

| Plan       | Time range                         |
|------------|-------------------------------------|
| Free       | Last 24 hours |
| Starter    | Last 30 days |
| Pro        | Last 90 days |
| Business   | Last 365 days |
| Ultimate   | No limits |
| Enterprise | No limits |

**The default interval of returned data for OHLCV is 24 hours:**
```
[
  {
    "time_open": "2020-01-01T00:00:00Z",
    "time_close": "2020-01-01T23:59:59Z",
    "open": ...,
    "high": ...,
    "low": ...,
    "close": ...,
    "volume": ...,
    "market_cap": ...
  }
  ...
]
```

**However, depending on your API plan, you can set a smaller interval by using the query parameter `interval`:**

| Plan       | `interval` parameter value          |
|------------|-------------------------------------|
| Free       | `24h` |
| Starter    | `24h` |
| Pro        | `24h` |
| Business   | `1h`, `6h`, `12h`, `24h` |
| Ultimate   | `1h`, `6h`, `12h`, `24h` |
| Enterprise | `5m`, `15m`, `30m`, `1h`, `6h`, `12h`, `24h` |

**Update interval:** Every 5 minute.

## Path parameters

- `coin_id` string, required

## Query parameters

- `start` string, required
- `end` string
- `limit` integer
- `interval` string
- `quote` string

## Response `200`

successful operation

- CoinsOhlcv[]
  - `time_open` string: RFC3999 (ISO-8601) format
  - `time_close` string: RFC3999 (ISO-8601) format
  - `open` number, nullable
  - `high` number, nullable
  - `low` number, nullable
  - `close` number, nullable
  - `volume` integer, nullable
  - `market_cap` integer, nullable
  - `circulating_supply` integer: Circulating supply implied by the entry (`market_cap / close` in USD); an approximation, not a recorded supply value. Returned only on Business, Ultimate and Enterprise plans, omitted when market cap or price is missing.

## Other responses

- `404`: not found
- `429`: too many requests

---

[API](https://skmtc.dev/coinpaprika/apis/coinpaprika-api.md) - [All operations](https://skmtc.dev/coinpaprika/apis/coinpaprika-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinpaprika/apis/coinpaprika-api/revisions/36a2a796d93f?raw)