# Meerkat Strategy

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-senpi-ai-senpi-skills-meerkat`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Senpi-ai](https://agentstack.voostack.com/s/senpi-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Senpi-ai](https://github.com/Senpi-ai)
- **Source:** https://github.com/Senpi-ai/senpi-skills/tree/main/meerkat

## Install

```sh
agentstack add skill-senpi-ai-senpi-skills-meerkat
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🦦 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 | max_loss_pct | 18% |
| Phase 1 | retrace_threshold | 10 |
| Time cuts | hard_timeout | **36h (short — momentum is time-bounded)** |
| Time cuts | weak_peak_cut | DISABLED |
| Time cuts | dead_weight_cut | 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](https://github.com/Senpi-ai)
- **Source:** [Senpi-ai/senpi-skills](https://github.com/Senpi-ai/senpi-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-senpi-ai-senpi-skills-meerkat
- Seller: https://agentstack.voostack.com/s/senpi-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.