Available methods

viewCoinHistory

Method base path https://www.cryptocurrencychart.com/api/coin/history

Retrieves 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/view

View 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/list

Provides 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-cap

A 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/list

Provides 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.
(string)

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/list

Provides 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.
(string)

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"]}