scanning-market-movers

# Scanning Market Movers

## Overview

Real-time detection and analysis of significant price movements and unusual volume patterns across cryptocurrency markets. This skill identifies top gainers, losers, and volume spikes, ranking them by a composite significance score.

**Key Features:**
- Scan 1,000+ cryptocurrencies for movers
- Configurable thresholds (change %, volume spike, market cap)
- Significance scoring for prioritization
- Category filtering (DeFi, L2, NFT, etc.)
- Multiple output formats (table, JSON, CSV)

**Dependency:**
This skill uses `tracking-crypto-prices` from `market-price-tracker` plugin for price data infrastructure.

## Prerequisites

Install required dependencies:

```bash
pip install requests pandas
```

**Dependency Setup:**
Ensure `market-price-tracker` plugin is installed with `tracking-crypto-prices` skill configured.

## Instructions

### Step 1: Quick Market Scan

Run a default scan for top gainers and losers:

```bash
python {baseDir}/scripts/scanner.py
```

This returns the top 20 gainers and top 20 losers by 24h change with volume confirmation.

### Step 2: Custom Thresholds

Scan with specific criteria:

```bash
# Only show moves > 10% with volume spike > 3x
python {baseDir}/scripts/scanner.py --min-change 10 --volume-spike 3

# Filter by market cap
python {baseDir}/scripts/scanner.py --min-cap 100000000 --max-cap 1000000000
```

### Step 3: Category Filtering

Focus on specific sectors:

```bash
# DeFi tokens only
python {baseDir}/scripts/scanner.py --category defi

# Layer 2 tokens
python {baseDir}/scripts/scanner.py --category layer2

# Available: defi, layer2, nft, gaming, meme
```

### Step 4: Different Timeframes

Scan across timeframes:

```bash
# 1-hour movers
python {baseDir}/scripts/scanner.py --timeframe 1h

# 7-day movers
python {baseDir}/scripts/scanner.py --timeframe 7d
```

### Step 5: Export Results

Save results for analysis:

```bash
# JSON export
python {baseDir}/scripts/scanner.py --format json --output mover