crypto-market-cli
v5.0.0Track crypto prices, portfolios, and market data via CoinGecko. Use when checking coin prices, managing a portfolio, setting alerts, or comparing cryptocurrencies.
Installation
crypto-market-cli
Cryptocurrency market toolkit — get live prices from CoinGecko API, manage watchlists and portfolios, view price history with sparkline charts, set price alerts, and compare coins.
Commands
price
Get live price, 24h change, and market cap for a coin from CoinGecko.
scripts/script.sh price bitcoin
scripts/script.sh price ethereum eur
search
Search for coins by name or symbol. Returns top 10 results with rank.
scripts/script.sh search "solana"
track
Add a coin to your local watchlist.
scripts/script.sh track bitcoin
scripts/script.sh track ethereum
watchlist
Display all watchlist coins with current prices and 24h changes (fetched live).
scripts/script.sh watchlist
portfolio
Manage your portfolio — record buys and view current holdings with live P/L.
scripts/script.sh portfolio add bitcoin 0.5 42000
scripts/script.sh portfolio add ethereum 2.0 3200
scripts/script.sh portfolio show
history
View price history for a coin over N days, with sparkline visualization.
scripts/script.sh history bitcoin 7
scripts/script.sh history ethereum 30
compare
Side-by-side price comparison of two coins.
scripts/script.sh compare bitcoin ethereum
gas
Ethereum gas price information and links.
scripts/script.sh gas
alert
Set and view price alerts (stored locally).
scripts/script.sh alert add bitcoin 50000 above
scripts/script.sh alert add ethereum 2000 below
scripts/script.sh alert list
stats
Show usage statistics — watchlist size, portfolio entries, alerts count.
scripts/script.sh stats
export
Export portfolio data as JSON or CSV.
scripts/script.sh export json
scripts/script.sh export csv
help
scripts/script.sh help
version
scripts/script.sh version
Examples
# Quick price check
scripts/script.sh price bitcoin
scripts/script.sh price solana
# Build a watchlist
scripts/script.sh track bitcoin
scripts/script.sh track ethereum
scripts/script.sh track solana
scripts/script.sh watchlist
# Track portfolio P/L
scripts/script.sh portfolio add bitcoin 0.1 45000
scripts/script.sh portfolio show
# Research
scripts/script.sh history bitcoin 30
scripts/script.sh compare bitcoin ethereum
Configuration
| Variable | Required | Description |
|---|---|---|
CRYPTO_CLI_DIR |
No | Data directory (default: ~/.crypto-market-cli/) |
Data Storage
All data saved in ~/.crypto-market-cli/:
- watchlist.txt — Tracked coins
- portfolio.jsonl — Buy records
- alerts.jsonl — Price alerts
- history.log — Query history
Requirements
- bash 4.0+
- curl (for CoinGecko API calls)
- python3 (for JSON parsing)
CoinGecko free API — no key required, rate-limited to ~10 requests/minute.
Powered by BytesAgain | bytesagain.com | [email protected]