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