Finance Watcher
Monitor stock and cryptocurrency prices with ease. Set alerts, track your portfolio, and generate daily reports.
Features
- ✅ Real-time Prices - Crypto (CoinGecko) & Stocks (Yahoo Finance)
- ✅ Price Alerts - Get notified when prices hit your targets
- ✅ Portfolio Tracking - Watchlist for all your assets
- ✅ Daily Reports - Markdown reports with price changes
- ✅ No API Key - Free data sources, no registration needed
Quick Start
# Install
npm install
# Add assets to watchlist
finance-watcher add BTC --type crypto
finance-watcher add AAPL --type stock
# Check current prices
finance-watcher prices
# Set an alert
finance-watcher alert BTC --above 50000
# Generate report
finance-watcher report --output daily-report.md
Commands
| Command | Description |
|---|---|
add <symbol> | Add to watchlist (--type crypto/stock) |
remove <symbol> | Remove from watchlist |
list | Show watchlist |
prices | Get current prices |
alert <symbol> | Set price alert (--above, --below, --percent) |
check | Check all alerts |
report | Generate portfolio report |
Data Sources
- Crypto: CoinGecko API (free, no key)
- Stocks: Yahoo Finance API (unofficial, free)
Use Cases
- Personal Portfolio - Track your investments daily
- Trading Alerts - Never miss entry/exit points
- Market Research - Compare crypto vs stock performance
- Automated Reports - Schedule daily summaries
Integration
Works great with:
- Cron jobs for scheduled checks
- Feishu/Slack webhooks for alerts
- Content Watcher for market news + price data combo