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-prices skill 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 cap
Resources
${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
1---2name: scanning-market-movers3description: |4 Detect significant price movements and unusual volume across crypto markets.5 Calculates significance scores combining price change, volume ratio, and market cap.6 Use when tracking market movers, finding gainers/losers, or detecting volume spikes.7 Trigger with phrases like "scan market movers", "top gainers", "biggest losers",8 "volume spikes", "what's moving", "find pumps", or "market scan".9allowed-tools: Read, Write, Edit, Grep, Glob, Bash(python:*)10version: 2.0.011author: Jeremy Longshore <jeremy@intentsolutions.io>12license: MIT13compatible-with: claude-code, codex, openclaw14tags: [crypto, scanning-market]1516---1718# Scanning Market Movers1920## Overview2122Real-time detection of significant price movements and unusual volume patterns across 1,000+ cryptocurrencies, ranked by composite significance score.2324## Prerequisites25261. **Python 3.8+** installed272. **Dependencies**: `pip install requests pandas`283. **market-price-tracker** plugin installed with `tracking-crypto-prices` skill configured2930## Instructions31321. **Run a default scan** for top gainers and losers (top 20 each by 24h change with volume confirmation):33 ```bash34 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py35 ```36372. **Set custom thresholds** for minimum change and volume spike:38 ```bash39 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --min-change 10 --volume-spike 340 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --min-cap 100000000 --max-cap 1000000000 # 100000000 = $100M min cap, 1000000000 = $1B max cap41 ```42433. **Filter by category** (defi, layer2, nft, gaming, meme):44 ```bash45 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --category defi46 ```47484. **Scan different timeframes** (1h, 24h, 7d):49 ```bash50 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --timeframe 1h51 ```52535. **Export results** to JSON or CSV:54 ```bash55 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --format json --output movers.json56 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --format csv --output movers.csv57 ```58596. **Use named presets** for predefined threshold sets:60 ```bash61 python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --preset aggressive62 ```6364## Output6566Default table shows top gainers and losers ranked by significance score (0-100), combining price change (40%), volume ratio (40%), and market cap (20%):6768```69================================================================================70 MARKET MOVERS Updated: 2025-01-14 15:30:00 # 2025 timestamp71================================================================================7273 TOP GAINERS (24h)74--------------------------------------------------------------------------------75 Rank Symbol Price Change Vol Ratio Market Cap Score76--------------------------------------------------------------------------------77 1 XYZ $1.234 +45.67% 5.2x $123.4M 89.378 2 ABC $0.567 +32.10% 3.8x $45.6M 76.579 3 DEF $2.890 +28.45% 2.9x $234.5M 71.280--------------------------------------------------------------------------------8182 TOP LOSERS (24h)83--------------------------------------------------------------------------------84 Rank Symbol Price Change Vol Ratio Market Cap Score85--------------------------------------------------------------------------------86 1 GHI $3.456 -28.90% 4.1x $89.1M 72.187 2 JKL $0.123 -22.34% 2.5x $12.3M 58.988--------------------------------------------------------------------------------8990 Summary: 42 movers found | Scanned: 1000 assets # 1000 assets in scan universe91================================================================================92```9394## Error Handling9596| Error | Cause | Solution |97|-------|-------|----------|98| `Dependency not found` | tracking-crypto-prices unavailable | Install market-price-tracker plugin |99| `No movers found` | Thresholds too strict | Relax thresholds with lower values |100| `Rate limit exceeded` | Too many API calls | Wait or use cached data |101| `Partial results` | Some assets unavailable | Normal, proceed with available data |102103See `${CLAUDE_SKILL_DIR}/references/errors.md` for comprehensive error handling.104105## Examples106107Common scanning patterns for different market analysis scenarios:108109```bash110# Daily scan - top 20 gainers/losers111python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --timeframe 24h --top 20112113# Volume spike hunt (5x+ volume, $1M+ daily volume)114python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --volume-spike 5 --min-volume 1000000 # 1000000 = $1M min volume115116# DeFi movers exported to CSV117python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --category defi --format csv --output defi_movers.csv118119# High-cap gainers only (>$1B market cap)120python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --min-cap 1000000000 --gainers-only --top 10 # 1000000000 = $1B cap121```122123## Resources124125- `${CLAUDE_SKILL_DIR}/references/implementation.md` - Configuration, presets, JSON format, scoring details126- `${CLAUDE_SKILL_DIR}/references/errors.md` - Comprehensive error handling127- `${CLAUDE_SKILL_DIR}/references/examples.md` - Detailed usage examples128- Depends on: tracking-crypto-prices skill129- CoinGecko API: https://www.coingecko.com/en/api130