---
name: opencatz-swarm-trading
description: Autonomous multi-agent crypto trading skill for Robinhood Chain EVM DEX tokens and NFTs using 3-layer Swarm Consensus, Discord Command Center, and Position Management.
---

# OpenCatz Swarm Trading & Intelligence Skill

This skill defines the operational standards, decision pipelines, and multi-agent coordination rules for the **Opencatz AI (Robinhood Chain Edition)** ecosystem.

---

## 1. Robinhood Chain Meme Signal Categories

Screening agents scan across 3 high-potential token opportunities:

1. 🐣 **Established Launches & CTO Tokens:** Robinhood DEX tokens with active DEX liquidity and a Community Takeover (CTO) or dev-closed profile (no age gate — `minAgeHours=0` in both presets).
2. 🧟 **Revival & CTO Tokens (Dead Tokens Waking Up):** Established tokens (>= 4h age) with a sudden **1H price move > +50%**, **2+ GMGN Smart Wallet** accumulation, and dev 0% / CTO (Community Takeover).
3. 🚀 **Volume Surge & Trend Breakouts:** Tokens breaking key resistance levels confirmed by 1H GMGN Smart Money Net Inflows.

> **Configurable thresholds:** thresholds below are the **LOOSENED defaults (2x)** configured at onboarding; users can switch to Standard, edit numbers, or supply a custom strategy prompt (compiled by OpenCatz after deploy). All gates fail-closed; swarm **>= 80% floor unchanged**.

### Layer 1: Quant & Liquidity Audit

- **Timeframe:** 24H (24-hour rolling volume, liquidity, and trend evaluation).
- **Minimum Token Age:** loosened default **`minAgeHours=0`** — degen early access (new tokens pass immediately — smart money/CTO/KOL decide); the age gate is only enforced when `minAgeHours > 0` is configured (e.g. via `set_screening_config` in the control room). Standard preset: **`minAgeHours=0` too** — the age gate is off in both presets; the Revival signal type still requires tokens >= 4h old.
- **Minimum Volume:** loosened default **24h volume ≥ $25,000** (Standard: **24h volume ≥ $50,000**). Both are plain 24h gates — no hourly-volume or surge-ratio gate exists.
- **Minimum Liquidity:** loosened default **$5,000 USD** (Standard: **$10,000 USD**).
- **Minimum Fees:** loosened default **total fees ≥ $250** (Standard: **total fees ≥ $500**; the gate only enforces when configured > 0).
- **Transaction Ratio:** Buy vs Sell transaction ratio evaluation (momentum requires buy dominance).

### Layer 2: Catalyst & Social Hype Audit

- **GMGN Social Data:** Uses GMGN social fields (smart-money wallet counts, KOL counts, square mentions, visiting count, X/twitter activity flags — rename/delete/post counts) to score hype deterministically with local rules.
- **LLM Sentiment:** LLM reasoning is reserved for high-value tasks only — interpreting social sentiment for the final AI Thesis and answering user chat queries in the command room (token & API cost optimization). Screening passes themselves are deterministic.
- **Narrative Match:** Viral meme topic & community engagement scoring.

### Layer 3: Security & Runner Token Audit Checklist (GMGN `/token/security`)

Flexible thresholds designed to capture **high-potential RUNNER tokens** while avoiding scams. These map to GMGN security fields available for the robinhood chain; where a field is unavailable, the audit is **fail-closed** (unverified = rejected):

1. 👥 **Top 10 Holders Control:** MUST be <= 25% (allows healthy community & cabal backing).
2. 👨💻 **Dev Holding %:** MUST be <= 10% (allows marketing/airdrop reserve).
3. 🐋 **Snipers %:** MUST be <= 20% (realistic sniper threshold for runner tokens).
4. 🕵️ **Insiders %:** MUST be <= 20% (realistic team/insider allocation).
5. 🤖 **Bundler %:** MUST be <= 25% (allows early bundler momentum for runner launches).
6. 🎣 **Phishing Risk %:** MUST be <= 3%.
7. 💳 **Dex Paid Status:** MUST be DexScreener Paid (Paid status is mandatory to filter out low-effort rugs).
8. 🚫 **NoMint:** Mint Authority MUST be disabled.
9. 🛡️ **No Blacklist:** Blacklist Authority MUST be disabled.
10. 🔥 **Burnt LP %:** 100% LP Burned / Permanent Lock.
11. ⚠️ **Rug Risk Score %:** Overall calculated Rug Risk MUST be <= 5% (Runner Safe Zone).
12. 📊 **Holder Count Growth:** Unique holders count verification.

- **Fail-Closed Note:** every Layer 3 audit gate runs through GMGN `/v1/token/security` (per-token audit endpoint) + GMGN rank security fields. A missing/unavailable audit field or failed audit = REJECT — tokens are never passed on missing data.
- **Global Risk Limit:** Verify daily portfolio drawdown < 5%.

---

## 2. Discord Call & Execution Standards

- **Informational Calls:** Deliver to dedicated channels (`#call-meme-robinhood`, `#call-lp-robinhood`, `#call-nft-robinhood`, `#call-alpha-robinhood`, `#call-whale-eth`).
- **Interactive Action Links & Buttons:** Provide `[VIEW ON DEXSCREENER]`, `[TRADE ON UNISWAP]`, and `[PAUSE SCREENING]`.
- **Command Execution:** User buys are executed securely via OpenCatz Core Hub in `#opencatz-control-room`.

---

## 3. Position Management (Auto TP / SL)

Upon trade execution:

- **Take Profit (TP):** Scale out 50% at +100% (2x), 25% at +200% (3x).
- **Stop Loss (SL):** Hard stop loss execution if token drops by configured limit (default -20%).
- **Trailing Stop:** Adjust stop loss upwards dynamically as high-water mark increases.

---

## 4. Trade Audit & Diagnostic Logging

- Log every signal, thesis, entry price, execution time, and exit PnL in the database.
- Support natural language trade diagnostics when queried in Discord.