Emerging Movers Detector v3.1

Tracks Smart Money market concentration across all Hyperliquid assets and flags assets accelerating up the ranks before they become crowded top-3 plays. By the time an asset hits the top of the SM leaderboard, the easy money is gone. This catches the trajectory.

One API call per scan. Near-zero LLM tokens. Runs every 60 seconds.

How It Works

The SM Profit Concentration Leaderboard

Senpi's leaderboard_get_markets returns all assets ranked by percentage of total Smart Money profit in the last 4-hour rolling window. This isn't trader count — it's where the money is actually flowing.

#1  ETH SHORT   31.4%  286 traders
#2  BTC SHORT   25.1%  436 traders
#3  HYPE SHORT  24.2%  330 traders
...
#36 ASTER SHORT  0.2%   18 traders  ← 60s later: #13, 0.82%, 65 traders

The script tracks this leaderboard over time and detects acceleration.

Detection Signals

Immediate Action Signals (v3+)

Trend Signals

v3.1 Quality Filters

These prevent false IMMEDIATE signals that looked great on rank jump alone but failed on execution:

See references/quality-filters.md for implementation details and real-world examples.

Architecture

┌────────────────────────────────────┐
│ Cron: every 60 seconds             │
├────────────────────────────────────┤
│ scripts/emerging-movers.py         │
│ • Loads scan history from JSON     │
│ • Fetches leaderboard (1 API call) │
│ • Parses top 50 markets            │
│ • Compares with previous scans     │
│ • Detects signals + v3.1 filters   │
│ • Saves updated history            │
│ • Outputs JSON with alerts         │
├────────────────────────────────────┤
│ Agent reads output:                │
│ • IMMEDIATE alerts → evaluate now  │
│ • Deep climbers → queue for review │
│ • No alerts → silent               │
└────────────────────────────────────┘

Files

Output

See references/output-schema.md for the complete JSON schema.

Key top-level fields: alerts[], topMovers[], immediateMovers[], deepClimbers[], scanCount, timestamp.

Per-alert fields: asset, direction, rank, prevRank, contribution, traderCount, reasons[], contribVelocity, isImmediate, isDeepClimber, erratic, lowVelocity.

Cron Setup

*/1 * * * * python3 scripts/emerging-movers.py

Agent Response Logic

• isImmediate: true + erratic: false + lowVelocity: false → Evaluate immediately for entry via Scanner
• isDeepClimber: true → Queue for next scanner run
• erratic: true or lowVelocity: true → Log but do not act
• No alerts → Silent

Companion skills

• opportunity-scanner — use Scanner to deep-dive assets flagged by Emerging Movers
• autonomous-trading — full loop integrating Emerging Movers as entry trigger
• wolf-strategy — uses IMMEDIATE_MOVER as primary entry signal