Get the price history for CoinMarketCap-listed currencies
CoinMarketCap history scraper
Use this library as a command-line script to obtain historical cryptocurrency data on the fly, or import the library to obtain cryptocurrency data for your programs.
Download the zip file or navigate to the desired install directory and run:
$ git clone https://github.com/Alescontrela/coinmarketcap-history.git
To install the required dependencies, navigate into the repo and run:
$ pip install -r requirements.txt
Among other things, this is useful for US tax reporting. If you want to know the cost basis for a trade (or for coins acquired through mining), the IRS requires you to denominate that cost basis in USD. In the case of token-for-token trades (e.g. purchasing ETH with BTC), that requires you know the USD:BTC exchange rate at the time of the trade.
Surprisingly, as of October 2017, it's not easy to get this data in a machine-readable format anywhere online.
Rather than getting the exchange rate at the exact moment of your trade, which is generally not feasible, the IRS standard (at least for similar situations w/stock) is to use the average of a stock's high and low price for the day. CoinMarketCap doesn't provide this figure, but this tool calculates this number and includes it in the output.
Command Line Usage
In the terminal, navigate into the repo directory and run:
$ python coinmarketcap.py <currency1> <start_date> <end_date>
currencyis the (case-insensitive) name of the currency / token as displayed on CoinMarketCap, with dashes in place of spaces
start_dateis the beginning of the range to fetch data for in
yyyy-mm-ddformat. For example, 2017-10-01 (for 2017 October 10th)
end_yearis the end of the range to fetch data for in
yyyy-mm-ddformat. You may use a date in the future to obtain the latest data. Format is the same as in the start date.
Data for multiple cryptocurrencies can be obtained with:
$ python coinmarketcap.py <currency_1,currency_2,...,currency_n> <start_date> <end_date>
Note: currencies must be comma-separated, with no spaces in between.
The above information can also be found by running:
$ python coinmarketcap.py -h
Write outputs to a file by running:
$ coinmarketcap.py <currency> <start_date> <end_date> > <output_filename>
Command Line Examples
Collecting data for one cryptocurrency:
$ python coinmarketcap.py bitcoin 2017-01-01 2017-12-31
Collecting data for multiple cryptocurrencies:
$ python coinmarketcap.py bitcoin,ripple,ethereum 2017-01-01 2017-12-31
Writing output to a file:
$ python coinmarketcap.py bitcoin 2017-01-01 2017-12-31 > bitcoin_prices.csv
Writing output for multiple cryptocurrencies to a file:
$ python coinmarketcap.py bitcoin,ripple,ethereum 2017-01-01 2017-12-31 > bitcoin_ripple_ethereum_prices.csv
You can also use
coinmarketcap.py as a module in other python modules to get back a pandas dataframe with a cryptocurrency's history.
First, you may need to add the path to
coinmarketcap_usd_history.py in your
sys.path through a command like the following:
(Alternatively, just move the
coinmarketcap_usd_history.py file to the directory of the including module.)
Second, import the module:
Finally perform this to obtain the dataframe:
df = coinmarketcap_usd_history.main(['bitcoin','2017-01-01','2017-12-31','--dataframe'])
If you just wish to have the CSV output returned as a string to another python module, simply omit the
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size cmctestingthree-0.0.1-py3-none-any.whl (8.4 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size cmctestingthree-0.0.1.tar.gz (7.4 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for cmctestingthree-0.0.1-py3-none-any.whl