Quotes Historical
Returns an interval of historic quotes for any exchange based on time and interval parameters.
Technical Notes
A historic quote for every "interval" period between your "time_start" and "time_end" will be returned.
If a "time_start" is not supplied, the "interval" will be applied in reverse from "time_end".
If "time_end" is not supplied, it defaults to the current time.
At each "interval" period, the historic quote that is closest in time to the requested time will be returned.
If no historic quotes are available in a given "interval" period up until the next interval period, it will be skipped.
This endpoint supports requesting multiple exchanges in the same call. Please note the API response will be wrapped in an additional object in this case.
Interval Options
There are 2 types of time interval formats that may be used for "interval".
The first are calendar year and time constants in UTC time:
"hourly" - Get the first quote available at the beginning of each calendar hour.
"daily" - Get the first quote available at the beginning of each calendar day.
"weekly" - Get the first quote available at the beginning of each calendar week.
"monthly" - Get the first quote available at the beginning of each calendar month.
"yearly" - Get the first quote available at the beginning of each calendar year.
The second are relative time intervals.
"m": Get the first quote available every "m" minutes (60 second intervals). Supported minutes are: "5m", "10m", "15m", "30m", "45m".
"h": Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h".
"d": Get the first quote available every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d".
This endpoint is available on the following API plans:
Basic
Hobbyist (1 month)
Startup (1 month)
Standard (3 month)
Professional (Up to 12 months)
Enterprise (Up to 6 years)
Note: You may use the /exchange/map endpoint to receive a list of earliest historical dates that may be fetched for each exchange as first_historical_data. This timestamp will either be the date CoinMarketCap first started tracking the exchange or 2018-04-26T00:45:00.000Z, the earliest date this type of historical data is available for.
Cache / Update frequency: Every 5 minutes.
Plan credit use: 1 call credit per 100 historical data points returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: No equivalent, this data is only available via API outside of our volume sparkline charts in coinmarketcap.com/rankings/exchanges/.
Quotes Historical Returns an interval of historic quotes for any exchange based on time and interval parameters.
Technical Notes
Interval Options There are 2 types of time interval formats that may be used for "interval".
The first are calendar year and time constants in UTC time: "hourly" - Get the first quote available at the beginning of each calendar hour. "daily" - Get the first quote available at the beginning of each calendar day. "weekly" - Get the first quote available at the beginning of each calendar week. "monthly" - Get the first quote available at the beginning of each calendar month. "yearly" - Get the first quote available at the beginning of each calendar year.
The second are relative time intervals. "m": Get the first quote available every "m" minutes (60 second intervals). Supported minutes are: "5m", "10m", "15m", "30m", "45m". "h": Get the first quote available every "h" hours (3600 second intervals). Supported hour intervals are: "1h", "2h", "3h", "4h", "6h", "12h". "d": Get the first quote available every "d" days (86400 second intervals). Supported day intervals are: "1d", "2d", "3d", "7d", "14d", "15d", "30d", "60d", "90d", "365d".
This endpoint is available on the following API plans:
BasicNote: You may use the /exchange/map endpoint to receive a list of earliest historical dates that may be fetched for each exchange as
first_historical_data. This timestamp will either be the date CoinMarketCap first started tracking the exchange or 2018-04-26T00:45:00.000Z, the earliest date this type of historical data is available for.Cache / Update frequency: Every 5 minutes. Plan credit use: 1 call credit per 100 historical data points returned (rounded up) and 1 call credit per
convertoption beyond the first. CMC equivalent pages: No equivalent, this data is only available via API outside of our volume sparkline charts in coinmarketcap.com/rankings/exchanges/.