viewCoinHistory
Method base path
https://www.cryptocurrencychart.com/api/coin/historyRetrieves coin data of the specified type for the provided date range. Start date and end date can be at most 2 years apart.
Parameters
- coin (int) - Id of the coin to show history for.
- start (datetime string) - The start date of the period to get the coin data for. Format as YYYY-MM-DD.
- end (datetime string) - The end date of the period to get the coin data for. Format as YYYY-MM-DD.
- dataType (string) - The type of data you would like ot retrieve. See values in getDataTypes. - Default value: 'price'
- baseCurrency (string) - The base currency to use for price, market cap and trade volume data. See values in getBaseCurrencies. - Default value: 'USD'
Returns
An array of the provided data type over the provided period for the provided coin. Or an exception in case of an invalid parameter.
Description
coin (object)
id(integer)The coin id
name(string)The name of the coin
symbol(string)The symbol for the coin.
baseCurrency(string or null)The base currency used in the coins values.
date(string or null)The date for the price data formatted as YYYY-mm-dd.
price(float or null)The volume weighted average price for the coin on the provided date.
openPrice(float or null)The open price for the coin on the provided date.
closePrice(float or null)The last price for the coin on the provided date, if the date is the current day it is the most recent price for the day.
highPrice(float or null)The highest price for the coin on the provided date.
lowPrice(float or null)The lowest price for the coin on the provided date.
marketCap(float or null)The market capitalization for the coin on the provided date.
tradeVolume(float or null)The trade volume for the coin on the provided date.
fiatTradeVolume(float or null)The trade volume in markets against a fiat coin for the coin on the provided date.
rank(integer or null)The coin rank by market capitalization on the provided date.
supply(float or null)The number of coins available on the provided date.
tradeHealth(float or null)The percentage of the market capitalization of the coin that was traded on the provided date.
transactions(integer or null)The number of transactions, smart contract executions or other interactions with the coin.
fees(float or null)The number of fees paid for the coin.
utilityRating(float or null)The utility rating for the coin on the provided date.
sentiment(string or null)A sentiment indication for the coins market on the provided date.
firstData(string or null)The date of the first available data for the coin in the format of YYYY-mm-dd.
mostRecentData(string or null)The date of the most recent data for the coin in the format of YYYY-mm-dd.
status(string or null)The status of the coin.
dataType(string)The type of data.
baseCurrency(string)The base currency used for the data.
data (array of objects) The historical data.
date(string)The date for the value in the format of YYYY-mm-dd.
value(float or null)The value, the type depends on the dataType
Example request
https://www.cryptocurrencychart.com/api/coin/history/3099/2017-01-01/2017-01-02/marketCap/USD
Example response
{"coin":{"id":363,"name":"Bitcoin","symbol":"BTC"},"dataType":"marketCap","baseCurrency":"usd","data":[{"date":"2017-01-01","marketCap":"15419010992.00000000"},{"date":"2017-01-02","marketCap":"16249384569.00000000"},{"date":"2017-01-03","marketCap":"16605988581.00000000"}]}
viewCoin
Method base path
https://www.cryptocurrencychart.com/api/coin/viewView coin data for a specific date, if no date is specified the most recent coin data is shown.
Parameters
- coin (int) - Id of the coin to show data for.
- date (datetime string) - The date of the period to get the coin data for. Format as YYYY-MM-DD. No value returns the most recent data - Default value: NULL
- baseCurrency (string) - The base currency to use for price, market cap and trade volume data. See values in getBaseCurrencies. - Default value: 'USD'
Returns
An array of coin data in the specified base currency.
Description
coin (object)
id(integer)The coin id
name(string)The name of the coin
symbol(string)The symbol for the coin.
baseCurrency(string or null)The base currency used in the coins values.
date(string or null)The date for the price data formatted as YYYY-mm-dd.
price(float or null)The volume weighted average price for the coin on the provided date.
openPrice(float or null)The open price for the coin on the provided date.
closePrice(float or null)The last price for the coin on the provided date, if the date is the current day it is the most recent price for the day.
highPrice(float or null)The highest price for the coin on the provided date.
lowPrice(float or null)The lowest price for the coin on the provided date.
marketCap(float or null)The market capitalization for the coin on the provided date.
tradeVolume(float or null)The trade volume for the coin on the provided date.
fiatTradeVolume(float or null)The trade volume in markets against a fiat coin for the coin on the provided date.
rank(integer or null)The coin rank by market capitalization on the provided date.
supply(float or null)The number of coins available on the provided date.
tradeHealth(float or null)The percentage of the market capitalization of the coin that was traded on the provided date.
transactions(integer or null)The number of transactions, smart contract executions or other interactions with the coin.
fees(float or null)The number of fees paid for the coin.
utilityRating(float or null)The utility rating for the coin on the provided date.
sentiment(string or null)A sentiment indication for the coins market on the provided date.
firstData(string or null)The date of the first available data for the coin in the format of YYYY-mm-dd.
mostRecentData(string or null)The date of the most recent data for the coin in the format of YYYY-mm-dd.
status(string or null)The status of the coin.
Example request
https://www.cryptocurrencychart.com/api/coin/view/3099/2017-01-01/USD
Example response
{"coin":{"id":363,"baseCurrency":"USD","date":"2018-01-01","price":"15071.32556179","openPrice":"13941.10000000","closePrice":"15366.04008951","marketCap":"252814704202.47000122","tradeVolume":"16018274976.74300003","fiatTradeVolume":"0.00000000","rank":1,"supply":"16774550","tradeHealth":"6.92449087","transactions":753654,"fees":null,"utilityRating":null,"sentiment":"bearish","firstData":"2013-01-02","mostRecentData":"2018-01-01","status":"active"}}
getCoins
Method base path
https://www.cryptocurrencychart.com/api/coin/listProvides a list of available crypto currencies (coins).
Returns
A list of all available coins.
Description
coins (array of objects) The available coins.
id(integer)The coin id
name(string)The name of the coin
symbol(string)The symbol for the coin.
baseCurrency(string or null)The base currency used in the coins values.
date(string or null)The date for the price data formatted as YYYY-mm-dd.
price(float or null)The volume weighted average price for the coin on the provided date.
openPrice(float or null)The open price for the coin on the provided date.
closePrice(float or null)The last price for the coin on the provided date, if the date is the current day it is the most recent price for the day.
highPrice(float or null)The highest price for the coin on the provided date.
lowPrice(float or null)The lowest price for the coin on the provided date.
marketCap(float or null)The market capitalization for the coin on the provided date.
tradeVolume(float or null)The trade volume for the coin on the provided date.
fiatTradeVolume(float or null)The trade volume in markets against a fiat coin for the coin on the provided date.
rank(integer or null)The coin rank by market capitalization on the provided date.
supply(float or null)The number of coins available on the provided date.
tradeHealth(float or null)The percentage of the market capitalization of the coin that was traded on the provided date.
transactions(integer or null)The number of transactions, smart contract executions or other interactions with the coin.
fees(float or null)The number of fees paid for the coin.
utilityRating(float or null)The utility rating for the coin on the provided date.
sentiment(string or null)A sentiment indication for the coins market on the provided date.
firstData(string or null)The date of the first available data for the coin in the format of YYYY-mm-dd.
mostRecentData(string or null)The date of the most recent data for the coin in the format of YYYY-mm-dd.
status(string or null)The status of the coin.
Example request
https://www.cryptocurrencychart.com/api/coin/list
Example response
{"coins":[{"id":2024,"name":"007Coin","symbol":"007"},{"id":2097,"name":"020LondonCoin","symbol":"020"},{"id":2512,"name":"0x","symbol":"ZRX"},{"id":2743,"name":"10M Token","symbol":"10MT"},{"id":655,"name":"1337","symbol":"1337"}]}
getMarketCapCoins
Method base path
https://www.cryptocurrencychart.com/api/coin/market-capA list of coins including price data ordered by market capitalization (coins).
Parameters
- baseCurrency (string) - The base currency to use for price, market cap and trade volume data. See values in getBaseCurrencies. - Default value: 'USD'
- page (int) - The number of the requested list to display, for example page 2 with amount 100 will return coins 100 to 200. - Default value: 1
- amount (int) - The amount of coins to be returned per page, from 10 to 100. - Default value: 100
Returns
An array of coins and their price data ordered by market capitalization.
Description
page(integer)The result page number.
maximumPage(integer)The maximum number of pages for the amount per page.
amount(integer)The amount of coins per page returned.
coins (array of objects) The coins which the data belong to.
id(integer)The coin id
name(string)The name of the coin
symbol(string)The symbol for the coin.
baseCurrency(string or null)The base currency used in the coins values.
date(string or null)The date for the price data formatted as YYYY-mm-dd.
price(float or null)The volume weighted average price for the coin on the provided date.
openPrice(float or null)The open price for the coin on the provided date.
closePrice(float or null)The last price for the coin on the provided date, if the date is the current day it is the most recent price for the day.
highPrice(float or null)The highest price for the coin on the provided date.
lowPrice(float or null)The lowest price for the coin on the provided date.
marketCap(float or null)The market capitalization for the coin on the provided date.
tradeVolume(float or null)The trade volume for the coin on the provided date.
fiatTradeVolume(float or null)The trade volume in markets against a fiat coin for the coin on the provided date.
rank(integer or null)The coin rank by market capitalization on the provided date.
supply(float or null)The number of coins available on the provided date.
tradeHealth(float or null)The percentage of the market capitalization of the coin that was traded on the provided date.
transactions(integer or null)The number of transactions, smart contract executions or other interactions with the coin.
fees(float or null)The number of fees paid for the coin.
utilityRating(float or null)The utility rating for the coin on the provided date.
sentiment(string or null)A sentiment indication for the coins market on the provided date.
firstData(string or null)The date of the first available data for the coin in the format of YYYY-mm-dd.
mostRecentData(string or null)The date of the most recent data for the coin in the format of YYYY-mm-dd.
status(string or null)The status of the coin.
Example request
https://www.cryptocurrencychart.com/api/coin/market-cap/1/25
Example response
{"page":1,"maximumPage":39,"amount":25,"coins":[{"id":2233,"baseCurrency":"USD","date":"2021-01-08","price":"0.37183534","openPrice":"0.36891232","closePrice":"0.37740695","highPrice":"0.39075631","lowPrice":"0.35723180","marketCap":"1033527598.01349998","tradeVolume":"25377035.17190500","fiatTradeVolume":"1086535.00545270","rank":26,"supply":"2779530283","tradeHealth":"3.72495529","transactions":753654,"fees":null,"utilityRating":null,"sentiment":"bullish","firstData":"2017-06-13","mostRecentData":"2021-01-08","status":"active"}]}
getDataTypes
Method base path
https://www.cryptocurrencychart.com/api/data-type/listProvides a list of data types to use with the viewCoinHistory call.
Returns
An array of data type strings.
Description
dataTypes (array) The available data types.
Example request
https://www.cryptocurrencychart.com/api/data-type/list
Example response
{"dataTypes":["price","priceChange","priceReturnOnInvestment","marketCap","marketCapChange","marketCapCumulativeChange","marketCapRank","tradeVolume","tradeVolumeChange","tradeVolumeCumulativeChange","priceSentiment","supply","tradeHealth","utilityRating","fees","transactions"]}
getBaseCurrencies
Method base path
https://www.cryptocurrencychart.com/api/base-currency/listProvides a list of base currencies used for the viewCoin and viewCoinHistory calls.
Returns
An array of base currency strings.
Description
baseCurrencies (array) The available base currencies.
Example request
https://www.cryptocurrencychart.com/api/base-currency/list
Example response
{"baseCurrencies":["USD","EUR","AUD","BGN","BRL","CAD","CHF","CNY","CZK","DKK","GBP","HKD","HRK","HUF","IDR","ILS","INR","JPY","KRW","MXN","MYR","NOK","NZD","PHP","PLN","RON","RUB","SEK","SGD","THB","TRY","ZAR"]}