🚀 Cacli - Crypto Analysis CLI

Crypto Analysis CLI - Interactive tool for analyzing cryptocurrency listing announcements with second-by-second precision.

Features

📊 Analysis Modes

• Interactive CLI - Traditional command-line interface with beautiful prompts
• Web Interface - Modern React-based web application for advanced analysis

🎯 Core Capabilities

• Second-by-second analysis of crypto trading data
• Listings performance tracking - analyze multiple exchange listings at once
• Market cap analysis - fetch and analyze market cap data from CoinGecko
• Volume correlation studies - discover patterns between pre-listing volume and performance
• Excel export - export analysis results to spreadsheet format

💻 Technical Features

• Smart file management - automatically detects existing data files
• Cross-platform data storage (macOS, Windows, Linux)
• Comprehensive metrics - OHLCV, volume analysis, buy/sell ratios
• Peak tracking - identifies exact timestamp of price peaks
• Production-ready web app - built and bundled for distribution
• Pre-loaded sample analyses - includes 37 real analysis files for immediate use

Installation

npm install -g @vnhlvn/cacli

Usage

Interactive CLI Mode

Run the traditional interactive analysis:

cacli

Web Interface Mode

Launch the modern web interface:

cacli web

The CLI tool will guide you through:

1. Data source selection - Choose existing files or download new data
2. Symbol input - Enter the trading pair (e.g., BTCUSDT, ETHUSDT)
3. Time range - Specify date, time, and analysis duration
4. Analysis - Get real-time progress and beautiful summary

The web interface provides:

1. Analysis Wizard - Configure and run detailed token analysis
2. Listings Summary - View comprehensive performance data across exchanges
3. Excel Export - Download results in spreadsheet format

Example Output

CLI Analysis

📊 BTCUSDT Analysis Summary

Symbol              │ BTCUSDT
Analysis Period     │ 10 minutes
Start Time          │ 2025-06-05T14:30:00Z
Total Volume        │ 1,234,567,890
Total Trades        │ 45,678
Range Open Price    │ $43,250.0000
Range Close Price   │ $43,890.0000
Peak Price          │ $44,125.0000 (2025-06-05T14:32:15Z)
Range Change        │ +1.48%
Price Peak          │ +2.03%

✔ Analysis saved: BTCUSDT_20250605_1430_10m.txt

Web Interface Features

• Analysis Wizard: Step-by-step configuration for detailed token analysis
• Listings Summary Table: Comprehensive view of multiple exchange listings
• Performance Metrics: 7-day volume totals, price changes, and market cap data
• Excel Export: One-click download of analysis results
• Real-time Error Handling: Clear feedback and troubleshooting tips

Data Sources

Cacli downloads data from Binance Vision - the official Binance historical data repository. Market cap data is fetched from CoinGecko API. All data is cached locally for fast repeated analysis.

Requirements

• Node.js 18.0.0 or higher
• Internet connection (for downloading new data and market cap information)

Data Storage

Cacli stores downloaded data in platform-specific directories:

• macOS: ~/Library/Application Support/crypto-analyzer/data/
• Windows: %APPDATA%/crypto-analyzer/data/
• Linux: ~/.local/share/crypto-analyzer/data/

Analysis reports are saved in your current working directory.

Sample Analyses

Cacli comes with 37 pre-loaded analysis files covering real cryptocurrency listings from various exchanges including:

• ALT, AXL, B3, BABY, ENA - Binance futures listings with comprehensive trading data
• INIT, MOODENGO, NEWT, RVN, SOPH - Multi-exchange analysis including volume and performance metrics
• Daily volumes, 7-day volumes, and detailed trading patterns - Ready-to-explore datasets

On first run, these analyses are automatically copied to your local data directory, giving you immediate access to real trading data without needing to perform your own analysis first.

Version History

• v1.2.8: Added 37 pre-loaded sample analyses for immediate use
• v1.2.7: Added web interface with Excel export and market cap analysis
• v1.2.x: Production web app integration, path resolution improvements
• v1.1.0: Enhanced listings summary and volume analysis
• v1.0.0: Initial release with CLI analysis

License

MIT