🦂 SCORPION v2.0 — Momentum Event Consensus
Patient ambush. Strike when smart money converges. Follow ACTIONS, not stale positions.
Why v2.0 Is a Complete Rewrite
SCORPION v1.1 was broken at the data source level. It used
discovery_get_top_traders
to find whales and
leaderboard_get_trader_positions
to mirror their positions. This returned ALL positions including legacy ones — months-old shorts showed up as fresh signals. Combined with loose filters (2 whales, 10-minute aging), the result was 406 trades, -24.2% ROI. Fee drag on 406 trades alone was devastating.
v2.0 uses leaderboard_get_momentum_events
These are real-time threshold-crossing events ($2M+/$5.5M+/$10M+) within a 4-hour rolling window. They capture when a trader's delta PnL crosses a significance level — this is an ACTION, not a stale position.
| Version | Scanner | Trades | ROI |
|---|
| v1.1 | Whale mirroring (stale positions) | 406 | -24.2% |
| v2.0 | Momentum event consensus (real-time) | Fresh start | Tracking |
Five-Gate Entry Model
Gate 1 — Momentum Events (primary signal)
Poll
leaderboard_get_momentum_events
for recent tier 1+ crossings within the last 60 minutes. These are traders whose delta PnL just crossed $2M+ (T1), $5.5M+ (T2), or $10M+ (T3).
Each event includes:
- : snapshot of which markets drove the momentum, with direction and delta PnL
- : how focused the trader's gains are (0-1)
- : TCS (Elite/Reliable/Streaky/Choppy) and TAS (Patient/Tactical/Active/Degen)
- : 1/2/3 significance level
Group events by asset+direction. 2+ unique traders on the same asset/direction = consensus.
Gate 2 — Trader Quality Filter
Not all momentum events are equal. Filter by:
- TCS: Only Elite and Reliable. Streaky/Choppy filtered out.
- TAS: Block Degen. Allow Patient, Tactical, Active.
- Concentration ≥ 0.4: Trader's gains are focused, not spread thin.
Gate 3 — Market Confirmation
Call
to check aggregate SM concentration on the asset. Requires 5+ top traders with significant positions. Confirms momentum events aren't isolated.
Gate 4 — Volume Confirmation
Call
to check 1h volume. Current volume must be ≥ 50% of 6h average. Don't enter into dead markets.
Gate 5 — Regime Filter (penalty, not block)
Check BTC 4h regime. Counter-trend entries get -3 penalty. Regime-aligned entries get +1 bonus. SM momentum may override regime, so this is a penalty not a block.
Scoring
| Component | Points | Notes |
|---|
| Trader count | 2 per trader | Core signal strength |
| Avg tier | 1-3 | Higher tiers = bigger moves |
| Avg concentration | 1-2 | High conviction traders |
| Market confirmation | 1-2 | Hot market bonus |
| Volume strength | 0-1 | Strong volume bonus |
| Regime alignment | -3 to +1 | Penalty/bonus |
Minimum score: 10 to trigger entry.
Entry Direction
SCORPION v2.0 enters WITH the smart money momentum. If SM is long, SCORPION goes long. This is follow-the-leader, not contrarian.
MANDATORY: DSL High Water Mode
SCORPION MUST use DSL High Water Mode. This is not optional.
DSL tiers in
. Arm DSL immediately after every entry fill. Zero naked positions.
Risk Management
| Rule | Value |
|---|
| Max positions | 3 |
| Max entries/day | 3 base, up to 6 on profitable days |
| Absolute floor | 3% notional |
| Drawdown halt | 20% from peak |
| Daily loss limit | 8% |
| Cooldown after 3 consecutive losses | 90 min |
| Stagnation TP | 10% ROE stale for 1 hour |
Cron Architecture
| Cron | Interval | Session | Purpose |
|---|
| Scanner | 5 min | isolated | Momentum events + consensus + all gates |
| DSL v5 | 3 min | isolated | High Water Mode trailing stops |
Both crons MUST be isolated sessions with
payload. Use
for idle cycles.
Notification Policy
ONLY alert: Position OPENED (asset, direction, trader count, avg tier, score breakdown), position CLOSED (DSL or thesis exit with reason), risk guardian triggered, critical error.
NEVER alert: Scanner found no events, quality filter removed events, no consensus, gates failed, DSL routine check, any reasoning.
Bootstrap Gate
On EVERY session, check
config/bootstrap-complete.json
. If missing:
- Verify Senpi MCP
- Create scanner cron (5 min, isolated) and DSL cron (3 min, isolated)
- Write
config/bootstrap-complete.json
- Send: "🦂 SCORPION v2.0 is online. Monitoring momentum events for SM consensus. Silence = no conviction."
Files
| File | Purpose |
|---|
scripts/scorpion-scanner.py
| Five-gate scanner (momentum events → quality → markets → volume → regime) |
scripts/scorpion_config.py
| Shared config, MCP helpers, state I/O |
config/scorpion-config.json
| All configurable variables with DSL High Water tiers |
License