scorpion-strategy

Original：🇺🇸 English

Translated

2 scriptsChecked / no sensitive code detected

SCORPION v2.0 — Momentum Event Consensus. Complete rewrite. Uses leaderboard_get_momentum_events (real-time threshold crossings) to detect when 2+ quality SM traders cross momentum thresholds on the same asset/direction within 60 minutes. Confirmed by market concentration + volume. Enters with the momentum. Replaces the v1.1 whale-mirroring scanner (406 trades, -24.2% ROI, stale position data).

2installs

Sourcesenpi-ai/senpi-skills

Added on2026-03-16

NPX Install

npx skill4agent add senpi-ai/senpi-skills scorpion-strategy

SKILL.md Content

View Translation Comparison →

🦂 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
as the primary data source. 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:

```
top_positions
```
: snapshot of which markets drove the momentum, with direction and delta PnL
```
concentration
```
: how focused the trader's gains are (0-1)
```
trader_tags
```
: TCS (Elite/Reliable/Streaky/Choppy) and TAS (Patient/Tactical/Active/Degen)
```
tier
```
: 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

leaderboard_get_markets

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

market_get_asset_data

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.

Spec: https://github.com/Senpi-ai/senpi-skills/blob/main/dsl-dynamic-stop-loss/dsl-high-water-spec%201.0.md

DSL tiers in

scorpion-config.json

. 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

agentTurn

payload. Use

NO_REPLY

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

MIT — Built by Senpi (https://senpi.ai). Source: https://github.com/Senpi-ai/senpi-skills