Scanning Market Movers
Overview
Real-time detection of significant price movements and unusual volume patterns across 1,000+ cryptocurrencies, ranked by composite significance score.
Prerequisites
- Python 3.8+ installed
- Dependencies:
pip install requests pandas - market-price-tracker plugin installed with
tracking-crypto-pricesskill configured
Instructions
- Run a default scan for top gainers and losers (top 20 each by 24h change with volume confirmation):
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py - Set custom thresholds for minimum change and volume spike:
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --min-change 10 --volume-spike 3 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --min-cap 100000000 --max-cap 1000000000 # 100000000 = $100M min cap, 1000000000 = $1B max cap - Filter by category (defi, layer2, nft, gaming, meme):
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --category defi - Scan different timeframes (1h, 24h, 7d):
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --timeframe 1h - Export results to JSON or CSV:
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --format json --output movers.json python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --format csv --output movers.csv - Use named presets for predefined threshold sets:
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --preset aggressive
Output
Default table shows top gainers and losers ranked by significance score (0-100), combining price change (40%), volume ratio (40%), and market cap (20%):
================================================================================
MARKET MOVERS Updated: 2025-01-14 15:30:00 # 2025 timestamp
================================================================================
TOP GAINERS (24h)
--------------------------------------------------------------------------------
Rank Symbol Price Change Vol Ratio Market Cap Score
--------------------------------------------------------------------------------
1 XYZ $1.234 +45.67% 5.2x $123.4M 89.3
2 ABC $0.567 +32.10% 3.8x $45.6M 76.5
3 DEF $2.890 +28.45% 2.9x $234.5M 71.2
--------------------------------------------------------------------------------
TOP LOSERS (24h)
--------------------------------------------------------------------------------
Rank Symbol Price Change Vol Ratio Market Cap Score
--------------------------------------------------------------------------------
1 GHI $3.456 -28.90% 4.1x $89.1M 72.1
2 JKL $0.123 -22.34% 2.5x $12.3M 58.9
--------------------------------------------------------------------------------
Summary: 42 movers found | Scanned: 1000 assets # 1000 assets in scan universe
================================================================================Error Handling
| Error | Cause | Solution |
|---|---|---|
Dependency not found | tracking-crypto-prices unavailable | Install market-price-tracker plugin |
No movers found | Thresholds too strict | Relax thresholds with lower values |
Rate limit exceeded | Too many API calls | Wait or use cached data |
Partial results | Some assets unavailable | Normal, proceed with available data |
See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.
Examples
Common scanning patterns for different market analysis scenarios:
# Daily scan - top 20 gainers/losers
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --timeframe 24h --top 20
# Volume spike hunt (5x+ volume, $1M+ daily volume)
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --volume-spike 5 --min-volume 1000000 # 1000000 = $1M min volume
# DeFi movers exported to CSV
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --category defi --format csv --output defi_movers.csv
# High-cap gainers only (>$1B market cap)
python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --min-cap 1000000000 --gainers-only --top 10 # 1000000000 = $1B capResources
${CLAUDE_SKILL_DIR}/references/implementation.md- Configuration, presets, JSON format, scoring details${CLAUDE_SKILL_DIR}/references/errors.md- Comprehensive error handling${CLAUDE_SKILL_DIR}/references/examples.md- Detailed usage examples- Depends on: tracking-crypto-prices skill
- CoinGecko API: https://www.coingecko.com/en/api