KOMODO v1.0 — Momentum Event Consensus. 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 MANTIS v1.0 and SCORPION v1.1 (both used stale position data).
Patient ambush. Devastating when it commits. Follow smart money ACTIONS, not stale positions.
MANTIS v1.0 and SCORPION v1.1 were broken at the data source level. Both used discovery_get_top_traders to find historically good whales, then read their current open positions. This returned ALL positions including legacy ones — BTC shorts opened months ago at $89-108k showed up as "fresh 8-whale consensus." The aging filters only checked scan duration, not when positions were actually opened.
KOMODO 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.
| Predecessor | Problem | Result |
|---|---|---|
| SCORPION v1.1 | 2 whales, 10min aging, stale positions |
| 406 trades, -24.2% |
| MANTIS v1.0 | 4 whales, 30min aging, stale positions | 0 trades (gates correct, data wrong) |
| KOMODO v1.0 | Real-time momentum events, quality filtering | New — tracking fresh |
KOMODO MUST use DSL High Water Mode. This is not optional.
DSL tiers in komodo-config.json. Arm DSL immediately after every entry fill. Zero naked positions.
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 PnLconcentration: 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 levelGroup events by asset+direction. 2+ unique traders on the same asset/direction = consensus.
Not all momentum events are equal. Filter by:
Call leaderboard_get_markets to check aggregate SM concentration on the asset. Requires 5+ top traders with significant positions in this market. Confirms momentum events aren't isolated.
Call market_get_asset_data to check 1h volume. Current volume must be ≥ 50% of 6h average. Don't enter into dead markets.
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.
| 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.
KOMODO enters WITH the smart money momentum. If SM is long, KOMODO goes long. This is follow-the-leader, not contrarian (that's OWL's job).
| 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 | 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.
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.
On EVERY session, check if config/bootstrap-complete.json exists. If not:
config/bootstrap-complete.json| File | Purpose |
|---|---|
scripts/komodo-scanner.py | Five-gate scanner (momentum events → quality → markets → volume → regime) |
scripts/komodo_config.py | Shared config, MCP helpers, state I/O |
config/komodo-config.json | All configurable variables with DSL High Water tiers |
When creating a strategy, include skill_name and skill_version in the call. See references/skill-attribution.md for details.