scanning-market-movers

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

1. Python 3.8+ installed
2. Dependencies: pip install requests pandas
3. market-price-tracker plugin installed with tracking-crypto-prices skill configured

Instructions

1. 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
   

2. 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
   

3. Filter by category (defi, layer2, nft, gaming, meme):

   python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --category defi
   

4. Scan different timeframes (1h, 24h, 7d):

   python ${CLAUDE_SKILL_DIR}/scripts/scanner.py --timeframe 1h
   

5. 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
   

6. 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