CryptoFetch - Historical Cryptocurrency Data Downloader

Interactive CLI tool to fetch historical OHLCV data directly from Binance API for any cryptocurrency.

Overview

CryptoFetch is a powerful command-line tool that downloads historical cryptocurrency price data from Binance. It features a clean terminal interface with real-time progress tracking and supports all USDT trading pairs available on Binance.

Features

• Clean Terminal Interface: Hacker-style color-coded output
• Symbol Verification: Validates trading pairs before downloading
• Multiple Timeframes: 15 intervals from 1m to 1M
• Custom Date Ranges: Flexible start/end date selection
• Real-time Progress: Live progress bars for each download
• Auto-organization: Creates folders and names files automatically
• All USDT Pairs: Supports 500+ cryptocurrencies on Binance

Prerequisites

pip install requests tqdm

Quick Start

python cryptofetch.py

Follow the prompts:

1. Enter cryptocurrency symbol (e.g., BTCUSDT, ETHUSDT, SOLUSDT)
2. Select timeframes (e.g., 1,4,6 for 1m, 15m, 1h or all for everything)
3. Enter start date (YYYY-MM-DD format)
4. Enter end date (YYYY-MM-DD format)
5. Specify output directory (or press Enter for default)
6. Confirm and download

Example Session

    ╔═════════════════════════════════════════════════════════════╗
    ║                                                             ║
    ║   ██████╗██████╗ ██╗   ██╗██████╗ ████████╗ ██████╗         ║ 
    ║  ██╔════╝██╔══██╗╚██╗ ██╔╝██╔══██╗╚══██╔══╝██╔═══██╗        ║
    ║  ██║     ██████╔╝ ╚████╔╝ ██████╔╝   ██║   ██║   ██║        ║
    ║  ██║     ██╔══██╗  ╚██╔╝  ██╔═══╝    ██║   ██║   ██║        ║
    ║  ╚██████╗██║  ██║   ██║   ██║        ██║   ╚██████╔╝        ║
    ║   ╚═════╝╚═╝  ╚═╝   ╚═╝   ╚═╝        ╚═╝    ╚═════╝         ║
    ║                                                             ║
    ║  ███████╗███████╗████████╗ ██████╗██╗  ██╗                  ║
    ║  ██╔════╝██╔════╝╚══██╔══╝██╔════╝██║  ██║                  ║
    ║  █████╗  █████╗     ██║   ██║     ███████║                  ║
    ║  ██╔══╝  ██╔══╝     ██║   ██║     ██╔══██║                  ║
    ║  ██║     ███████╗   ██║   ╚██████╗██║  ██║                  ║
    ║  ╚═╝     ╚══════╝   ╚═╝    ╚═════╝╚═╝  ╚═╝                  ║
    ║                                                             ║
    ║        Historical Crypto Data Downloader                    ║
    ║                                                             ║
    ║                                                             ║
    ║        [>] github.com/varshithkarkera                       ║
    ║                                                             ║
    ╚═════════════════════════════════════════════════════════════╝

[>] Enter cryptocurrency symbol (e.g., BTCUSDT, ETHUSDT, SOLUSDT):
>>> SOLUSDT

[>] Available intervals:
   1. 1m
   2. 3m
   3. 5m
   4. 15m
   5. 30m
   6. 1h
   7. 2h
   8. 4h
   9. 6h
  10. 8h
  11. 12h
  12. 1d
  13. 3d
  14. 1w
  15. 1M

[>] Select intervals (comma-separated, e.g., 1,4,6 or 'all'):
>>> 1,4,6

[>] Start date (YYYY-MM-DD):
>>> 2020-09-01

[>] End date (YYYY-MM-DD):
>>> 2026-01-03

[>] Output directory (default: sol/):
>>> 

=================================================================
[+] DOWNLOAD SUMMARY
=================================================================
  Symbol:      SOLUSDT
  Intervals:  1m, 15m, 1h
  Date Range: 2020-09-01 to 2026-01-03
  Output:     sol/
=================================================================

[?] Start download? (y/n):
>>> y

[+] Starting download...

[*] Fetching SOLUSDT 1m from 2020-09-01 to 2026-01-03
SOLUSDT 1m |████████████████████| 100.0%
[+] Saved 2,828,160 candles to sol/solusdt_1m.csv
...

Supported Cryptocurrencies

CryptoFetch supports all USDT trading pairs available on Binance, including:

• Bitcoin (BTCUSDT)
• Ethereum (ETHUSDT)
• Solana (SOLUSDT)
• BNB (BNBUSDT)
• XRP (XRPUSDT)
• Cardano (ADAUSDT)
• Dogecoin (DOGEUSDT)
• Polygon (MATICUSDT)
• And 500+ more...

Available Timeframes

1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M

Data Format

Each CSV file contains the following columns:

| Column | Description | |--------|-------------| | open_time_ms | Candle open time in milliseconds (Unix timestamp) | | open | Opening price | | high | Highest price during the period | | low | Lowest price during the period | | close | Closing price | | volume | Trading volume (base asset) | | close_time_ms | Candle close time in milliseconds (Unix timestamp) | | quote_asset_volume | Trading volume (quote asset, e.g., USDT) | | number_of_trades | Number of trades during the period | | taker_buy_base_asset_volume | Taker buy volume (base asset) | | taker_buy_quote_asset_volume | Taker buy volume (quote asset) | | ignore | Unused field (always 0) |

Data Source

Binance API

---

Bitcoin Historical Data

For Bitcoin historical data, check out this comprehensive Kaggle dataset:

• Source: Kaggle - Bitcoin Historical Datasets
• Timeframes: 15m, 1h, 4h, 1d
• Updated: Daily

---

License

This dataset is provided as-is under the MIT License. The data is sourced from Binance's public API.

Connect

• X: @varshithkarkera

---

Star History

<p align="center"> <img src="https://api.star-history.com/svg?repos=varshithkarkera/cryptofetch&type=Date&theme=dark&v=1" /> </p>

---

Made by Varshith Karkera