API Reference
Log In
API Reference

Coin Historical Chart Data within Time Range by Token Address

This endpoint allows you to get the historical chart data within certain time range in UNIX along with price, market cap and 24hr volume based on asset platform and particular token contract address

👍

Tips

  • You may obtain the asset platform and contract address via several ways:
    • refers to respective coin page and find ‘contract address'.
    • refers to /coins/list endpoint (include platform = true).
  • 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 (responses include information from the past 10 days, up until now)
    • interval=hourly: hourly historical data
(responses include information from the past 100 days, up until now)
  • 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

asset platform ID
*refers to /asset_platforms

string
required

the contract address of token

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