COcoinpaprika
Tickers

Get historical ticks for a specific coin

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 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:

Intervalinterval param valuesFreeStarterProBusinessUltimateEnterprise
Daily24h, 1d, 7d, 14d, 30d, 90d, 365dlast 1 yearlast 5 yearsunlimitedunlimitedunlimitedunlimited
Hourly1h, 2h, 3h, 6h, 12hlast 1 daylast 30 dayslast 90 dayslast 365 daysunlimitedunlimited
5-minute5m, 10m, 15m, 30m, 45mnonelast 7 dayslast 30 dayslast 365 daysunlimitedunlimited

Update interval: Every 5 minutes.

get/tickers/{coin_id}/historical

Request

Path parameters

coin_idstring required
Example:btc-bitcoin

Query parameters

startstring required

start point for historical data

Supported formats:

  • RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
  • Simple date (yyyy-mm-dd) eg. 2018-02-15
  • Unix timestamp (in seconds) eg. 1518671700
endstring

end point for historical data

Supported formats:

  • RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
  • Simple date (yyyy-mm-dd) eg. 2018-02-15
  • Unix timestamp (in seconds) eg. 1518671700
limitinteger

limit of result rows (max 5000)

quotestring

Quote currency of the returned data: usd or btc, no other values. Other currencies (EUR, PLN and more) exist only for current prices, through quotes on the ticker endpoints and through the price converter.

intervalstring

returned points interval (available values: 5m 10m 15m 30m 45m 1h 2h 3h 6h 12h 24h 1d 7d 14d 30d 90d 365d)

Response

successful operation

timestampstring

RFC3999 (ISO-8601) format

pricenumber
volume_24hinteger
market_capinteger
circulating_supplyinteger

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.

Example response

[
  {
    "timestamp": "2018-03-01T00:00:00Z",
    "price": 855.53,
    "volume_24h": 1968587956,
    "market_cap": 83761787514,
    "circulating_supply": 97906000
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.