🦦 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 <= maxEventAgeMinutes (default 30). An event with no timestamp is treated as fresh (the feed only returns current-window events). Stale momentum is somebody else's trade.

RULE 3: Confirmation is a bonus, not a gate

SM alignment (top-trader tilt on the same side) and rising 1h volume each add to the score but are not required — momentum events fire faster than SM data updates, so Meerkat won't wait for them.