API Reference
Log In
API Reference

Coin Historical Chart Data within Time Range by ID

This endpoint allows you to get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hr volume based on particular coin ID

👍

Tips

  • You may obtain the coin ID (API ID) via several ways:
    • refers to respective coin page and find ‘API ID’.
    • refers to /coins/list endpoint.
    • refers to google sheets here.
  • Supports ISO date strings (YYYY-MM-DD or
    YYYY-MM-DDTHH:MM, recommended for best compatibility) or UNIX timestamps.
📘

Notes

  • You may leave the interval params as empty for automatic granularity:
    • 1 day from current time = 5-minutely data
    • 1 day from any time (except current time) = hourly data
    • 2 - 90 days from any time = hourly data
    • above 90 days from any time = daily data (00:00 UTC)
  • For non-Enterprise plan subscribers who would like to get hourly data, please leave the interval params empty for auto granularity.
  • The 5-minutely and hourly interval params are also exclusively available to Enterprise plan subscribers, bypassing auto-granularity:
    • interval=5m: 5-minutely historical data, supports up to any 10 days date range per request.
    • interval=hourly: hourly historical data, supports up to any 100 days date range per request.
  • Data availability:
    • interval=5m: Available from 9 February 2018 onwards.
    • interval=hourly: Available from 30 Jan 2018 onwards.
  • Cache / Update Frequency:
    Based on days range (all the API plans)
    • 1 day = 30 seconds cache
    • 2 -90 days = 30 minutes cache
    • 90 days = 12 hours cache
    • The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC.
Path Params
string
required

coin ID
*refers to /coins/list.

Query Params
string
required

target currency of market data
*refers to /simple/supported_vs_currencies.

string
required

starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp.
use ISO date string for best compatibility

string
required

ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp.
use ISO date string for best compatibility

string
enum

data interval, leave empty for auto granularity

Allowed:
string
enum

decimal place for currency price value

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json