Meerkat Strategy

🦦 MEERKAT v1.0.0 — Momentum-Event Sniper

Stand sentry, pop the instant something moves. A meerkat watches the horizon and reacts the moment it spots motion. Meerkat watches the Senpi momentum-event feed and snipes the freshest, highest-tier momentum events the instant they fire — entering in the move's direction before it's broadly known.

Why this strategy exists

The momentum-event feed (leaderboard_get_momentum_events) surfaces assets that just made a sharp move in the 4h rolling window — the earliest, cleanest read on fresh momentum. The edge decays fast: an event that's already 30+ minutes old is half-known. Meerkat's whole job is speed + selectivity — only the strongest tiers, only while they're fresh.

CRITICAL RULES

RULE 1: Tier is the backbone

Each event's |momentum| is classified into a tier: 3 (strongest, >= tier3MinPct, default 10%), 2 (>= tier2MinPct, default 5%), else 1. Entry requires tier >= minTier (default 2; set to 3 for a pure tier-3 sniper). Weak events never fire.

RULE 2: Freshness is the sniper edge

Entry requires the event to be fresh — age = minTier AND fresh.

Score components (max ~7):

| Signal | Points | |---|---| | Tier (1 / 2 / 3) | +1 / +2 / +3 | | Fresh (age ≤ max) | +2 | | Smart Money confirms direction (≥ smTiltMinPct) | +1 | | SM strongly tilted (≥ smStrongTiltPct) | +1 | | 1h volume rising (> 15%) | +1 |

Floor: minScore: 4 (so a tier-2 fresh event clears; a tier-1 event never does).

DSL preset (let-winners-run — momentum-tuned)

| Phase | Component | Setting | |---|---|---| | Phase 1 | maxlosspct | 18% | | Phase 1 | retracethreshold | 10 | | Time cuts | hardtimeout | 36h (short — momentum is time-bounded) | | Time cuts | weakpeakcut | DISABLED | | Time cuts | deadweightcut | DISABLED | | Phase 2 | T0 → T4 | +10/0 · +20/45 · +35/65 · +55/78 · +90/88 |

Scanner pattern

A focused, event-driven variant of the Striker / rank-jump detector archetype (#6) — see senpi-trading-runtime/references/producer-patterns.md. Where the strikers (Jaguar/Orca/Roach) score a universe of leaderboard rank-jumps, Meerkat reads the momentum-event feed directly. Primary MCP calls: leaderboard_get_momentum_events (the producer signature; defensive multi-key unwrap), leaderboard_get_markets (SM), market_get_asset_data (volume confirmation). The pure functions (event_age_minutes, event_direction, momentum_tier, event_score) are unit-tested in tests/test_signal.py.

Operator install

See [README.md](README.md).

Changelog

v1.0.0 (2026-05-26) — initial release

First fleet agent driven directly off the momentum-event feed — a tier + freshness sniper, contrasting the universe-scanning rank-jump strikers. Let-winners-run DSL class (wide ladder, short 36h hard_timeout since momentum is time-bounded), taker-true entry, no null numeric signal fields, defensive multi-key shape unwrapping on leaderboard_get_momentum_events, and unit-tested pure functions (including epoch-seconds-vs-milliseconds handling).

License

MIT — Copyright 2026 Senpi (https://senpi.ai).

Skill Attribution

When creating a strategy, include skill_name and skill_version. See references/skill-attribution.md.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Senpi-ai
• Source: Senpi-ai/senpi-skills
• License: MIT

Install and usage instructions live in the source repository linked above.