---
title: "Get historical ticks for a specific coin"
method: GET
path: "/tickers/{coin_id}/historical"
tags: ["Tickers"]
---

# Get historical ticks for a specific coin

`GET /tickers/{coin_id}/historical`

## Request

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

Returns historical values of `price`, `volume_24h`, `market_cap` for a given cryptocurrency on coinpaprika.com.

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

Each point is produced by the same volume-weighted pipeline as the live ticker. See the [price calculation methodology](https://coinpaprika.com/methodology) for how markets are selected and outliers removed, and its algorithm history for changes that affect how older points compare with recent ones.

**Available history range depending on the selected API plan:**

| Interval | `interval` param values | Free | Starter | Pro | Business | Ultimate | Enterprise |
|---|---|---|---|---|---|---|---|
| Daily | `24h`, `1d`, `7d`, `14d`, `30d`, `90d`, `365d` | last 1 year | last 5 years | unlimited | unlimited | unlimited | unlimited |
| Hourly | `1h`, `2h`, `3h`, `6h`, `12h` | last 1 day | last 30 days | last 90 days | last 365 days | unlimited | unlimited |
| 5-minute | `5m`, `10m`, `15m`, `30m`, `45m` | none | last 7 days | last 30 days | last 365 days | unlimited | unlimited |

**Update interval:** Every 5 minutes.

## Path parameters

- `coin_id` string, required

## Query parameters

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

## Response `200`

successful operation

- HistoricalTick[]: Historical tick response.
  - `timestamp` string: RFC3999 (ISO-8601) format
  - `price` number
  - `volume_24h` integer
  - `market_cap` integer
  - `circulating_supply` integer: Circulating supply implied by the entry (`market_cap / price` 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

- `400`: invalid parameters
- `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)
