crypto-candlesticks
📈
The goal behind this project is to facilitate downloading cryptocurrency candlestick data fast & simple. Currently only the Bitfinex exchange is supported with more to come in future releases.
The command-line interface is built using Click, which is intuitive and will prompt you for the commands.
Once the data is downloaded, it will be converted and stored in a .csv, .sqlite3 and .pickle file for convenient analysis. The data will include the Open, High, Low, Close of the candles and the volume during the interval and its timestamp.
See documentation and Github repository.
Installation
To install the Crypto-candlesticks project, run this command in your terminal:
pip install crypto-candlesticks
Or if you are using Poetry
poetry add crypto-candlesticks
Usage
crypto-candlesticks can be used the following way:
$ crypto-candlesticks
"Welcome, what data do you wish to download?"
Which will prompt the following:
Cryptocurrency symbol to download (ie. BTC, ETH, LTC):
Base pair:
Interval to download the candlestick data:
Date to start downloading the data (ie. YYYY-MM-DD):
Date up to the data will be downloaded (ie. YYYY-MM-DD):
Or you can pass the arguments yourself and skip the prompt:
crypto-candlesticks [OPTIONS]
-s
, --symbol
The ticker you wish to download,
currently, only data from the Bitfinex exchange
is supported.
(e.g. [BTC|ETH|LTC] etc.)
-b
, --interval
The interval for each bar.
(e.g. [1m|5m|15m|30m|1h|3h|6h|12h|1D|7D|14D|1M])
-sd
, --start_date
YYYY, MM, DD from which the candlestick data will start. (e.g. [2018-01-01]) -ed
, --end date
YYYY, MM, DD up to which the candlestick data will be downloaded. (e.g. [2020-01-01]) --help Display a short usage message and exit.
Example output for CSV
✅
| Open | Close | High | Low | Volume | Ticker | Date | Time |
|---|---|---|---|---|---|---|---|
| 7203 | 7201 | 7203.7 | 7200.1 | 9.404174 | BTC/USD | 12/31/2019 | 16:00:00 |
| 7201 | 7223.6 | 7223.6 | 7201 | 7.9037398 | BTC/USD | 12/31/2019 | 16:01:00 |
| 7224.4 | 7225 | 7225.5 | 7224.4 | 0.4799298 | BTC/USD | 12/31/2019 | 16:02:00 |
| 7224.981 | 7225.9 | 7225.9 | 7224.981 | 0.9294573 | BTC/USD | 12/31/2019 | 16:03:00 |
| 7225.862 | 7225.7295 | 7225.9 | 7225.7295 | 0.2913202 | BTC/USD | 12/31/2019 | 16:04:00 |
| 7225.7 | 7225.8673 | 7225.9 | 7225.2973 | 1.0319704 | BTC/USD | 12/31/2019 | 16:05:00 |
Example output for SQL (the timestamp is shown in milliseconds)
✅
| ID | Timestamp | Open | Close | High | Low | Volume | Ticker | Interval |
|---|---|---|---|---|---|---|---|---|
| 1 | 1577868000000.0 | 7205.7 | 7205.8 | 7205.8 | 7205.7 | 0.07137942 | BTCUSD | 1m |
| 2 | 1577867940000.0 | 7205.70155305 | 7205.8 | 7205.8 | 7205.70155305 | 0.035 | BTCUSD | 1m |
| 3 | 1577867880000.0 | 7205.7 | 7205.70155305 | 7205.70155305 | 7205.7 | 0.025 | BTCUSD | 1m |
| 4 | 1577867820000.0 | 7205.75299748 | 7205.75299748 | 7205.75299748 | 7205.7 | 0.075 | BTCUSD | 1m |
| 5 | 1577867760000.0 | 7205.75299748 | 7205.2 | 7206.3 | 7205.2 | 0.005 | BTCUSD | 1m |
| 6 | 1577867700000.0 | 7205.2 | 7205.2 | 7205.2 | 7205.2 | 4.5802 | BTCUSD | 1m |
Contributing
Feel free to open an issue or pull request.
Buy me a coffee
ETH: 0x06Acb31587a96808158BdEd07e53668d8ce94cFE
46 Dec 9, 2022
470 Oct 8, 2022
116.4k Jan 7, 2023
1.8k Dec 30, 2022
2.7k Dec 31, 2022
1.6k Apr 12, 2022
64 Dec 25, 2022
468 Dec 29, 2022
16 Dec 12, 2022
5 Oct 07, 2022
3 Jan 21, 2022
46 Jan 09, 2023
2 Jan 19, 2022
1 Mar 05, 2022
190 Jan 08, 2023
4 Sep 28, 2022
1 Jan 10, 2022
6 Jun 08, 2022
3 Mar 05, 2022
4 Nov 04, 2021
1.2k Dec 27, 2022
4 Aug 31, 2022
7 Nov 24, 2022
3 Oct 06, 2022
3 Feb 11, 2022
9 Dec 23, 2022
2 Dec 25, 2021
24 Dec 09, 2022
2 Jun 21, 2022