▄▀▄    ▄▀▄                                              
  █   ▀▀▀▀   █    ▄▄▄▄  ▄▄▄▄▄ ▄   ▄  ▄▄▄▄  ▄▄▄  ▄▄▄▄▄ ▄▄▄▄▄
  █  ▄▄  ▄▄  █    █▄▄▄▀ █▄▄▄  █▀▄ █ █     █▄▄▄█   █     ▄▀ 
▄█    ▀   ▀   █▄  █     █▄▄▄▄ █  ▀█ ▀▄▄▄▄ █   █   █   ▄█▄▄▄
🐾 OPENCATZ AI (ROBINHOOD CHAIN EDITION) · EVM L2 (#4663) · NATIVE ETH DEX ENGINE
Autonomous Multi-Agent Crypto Intelligence & On-Chain Trading Engine

OpenCatz AI (Robinhood Chain Edition) is an autonomous, open-source Agentic AI Crypto Intelligence & Trading Ecosystem built exclusively for Robinhood Chain (EVM L2, Chain ID #4663, Native ETH).

It coordinates 5 Specialist AI Scouts across DEX tokens (Uniswap V3), concentrated liquidity pools (Krystal Cloud), NFTs (OpenSea), social sentiment (X API), and institutional ETH perps (Hyperliquid), governed by a 3-Layer Swarm Consensus Protocol (≥ 80% Confidence Gate) and the 9-Lives Automated Risk Engine.

Robinhood Portal · Global Web Portal · Discord Community · Twitter (@pxidentities) · Docs

# Clone the Robinhood Chain repository
git clone https://github.com/dizcorvus/opencatz-ai-robinhood-chain.git
cd opencatz-ai-robinhood-chain

# Install dependencies
npm install

# Link opencatz CLI globally (one-time)
npm link

# Run the interactive configuration wizard
opencatz onboard

# Or run the platform setup script:
bash setup.sh       # Linux / macOS
.\setup.bat         # Windows

The interactive wizard will guide you through:

1. Setting up your Discord Bot Token and Client ID.
2. Selecting your AI LLM Provider (OpenRouter, Claude, GPT-4, DeepSeek, Z.ai).
3. Configuring Web3 API keys (GMGN, OpenSea, Krystal Cloud, Twitter API).
4. Auto-testing your connection to Robinhood Chain RPC (https://rpc.robinhood.com).

# Start in live development mode (hot-reload)
opencatz run

# Or launch the interactive Terminal TUI Command Center
opencatz terminal

# Or deploy as a 24/7 background process daemon (PM2)
opencatz deploy

                          USER INTERFACES
              (Discord Server · Terminal TUI · Telegram Bridge)
                                    │
                                    ▼
                 ┌──────────────────────────────────────┐
                 │       OPENCATZ CORE AI HUB           │
                 │   #opencatz-control-room · Chat      │
                 │   9-Lives Risk Guard · Burner Wallet │
                 │   Strategy Compiler · Key Pool       │
                 └──────────────────┬───────────────────┘
                                    │
    ┌───────────────────────────────┼───────────────────────────────┐
    ▼                               ▼                               ▼
┌─────────────────────────┐ ┌─────────────────────────┐ ┌─────────────────────────┐
│  ROBINHOOD MEME SCOUT   │ │  ROBINHOOD LP YIELD     │ │  ROBINHOOD NFT SCOUT    │
│  Uniswap V3 / GMGN      │ │  Krystal Cloud / Uniswap│ │  OpenSea Robinhood      │
│  GoPlus Security Audit  │ │  Concentrated Liquidity │ │  Floor Surges & Mints   │
└───────────┬─────────────┘ └───────────┬─────────────┘ └───────────┬─────────────┘
            │                           │                           │
            └───────────────────────────┼───────────────────────────┘
                                        │
    ┌───────────────────────────────────┴───────────────────────────────────┐
    ▼                                                                       ▼
┌─────────────────────────┐                             ┌─────────────────────────┐
│  ALPHA & SENTIMENT      │                             │  HYPERLIQUID ETH WHALE  │
│  Twitter/X API v2       │                             │  Institutional Perps &  │
│  Robinhood Smart Money  │                             │  Spot Order Flow        │
└───────────┬─────────────┘                             └───────────┬─────────────┘
            └───────────────────────────┬───────────────────────────┘
                                        │ Candidate Opportunities
                                        ▼
                      ┌───────────────────────────────────┐
                      │    COLLABORATIVE AGENT CONSENSUS  │
                      │  Layer 1: Quant & Liquidity (40%) │
                      │  Layer 2: Sentiment & Catalysts (30%)
                      │  Layer 3: GoPlus & GMGN Audit (30%)│
                      │  ─── HARD GATE: ≥ 80% REQUIRED ── │
                      └─────────────────┬─────────────────┘
                                        │ Approved Signals
                                        ▼
                          MULTI-CHANNEL SIGNAL DISPATCH
                    (Take-Profit 2x/3x · Stop-Loss -20%)

• Core Hub & Orchestrator: Natural language chat, wallet balances, risk limits, and on-demand token audits.
• 5 Specialist Scouts: Autonomous agents monitoring DEX tokens, LP pools, NFTs, social sentiment, and ETH whale perps.
• Collaborative Consensus: 3-layer cross-verification demanding a $\ge 80%$ confidence score before delivering call cards.
• 9-Lives Risk Engine: Dynamic capital protection (-20% stop-loss, 2x/3x take-profit ladder, trailing stops).
• Universal Multi-Key Pool: Automatic rotation on HTTP 429/401/403 across unlimited backup keys.

Every trade candidate is governed by the automated 9-Lives Risk Engine:

• Hard Stop-Loss (-20%): Automated capital protection cutoff to eliminate catastrophic drawdowns.
• Tiered Take-Profit Ladder: Automated partial profit locking at +100% (2x) and +200% (3x).
• Dynamic Trailing Stop: Activates once a position reaches +50% profit to protect unrealized gains.
• Fail-Closed Security: If security checks (GoPlus/GMGN) encounter timeouts or warnings, candidate tokens are automatically discarded.
• Universal Multi-Key Pool: Stacks unlimited backup API keys (KEY_1..KEY_20) with instant auto-rotation on HTTP 429 (Rate Limit) or 401/403 errors.

OpenCatz AI (Robinhood Chain Edition) includes a complete automated test suite:

# Run full Vitest suite
npm test

 Test Files  35 passed (35)
      Tests  264 passed (264)
   Duration  ~11s

Contributions, bug fixes, and feature proposals for Robinhood Chain are warmly welcome! Please review our Contributing Guidelines and Code of Conduct before submitting pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feat/robinhood-enhancement)
3. Commit your changes (git commit -m 'feat: add robinhood feature')
4. Push to the branch (git push origin feat/robinhood-enhancement)
5. Open a Pull Request on GitHub

This project is open-source and licensed under the MIT License.

⚠️ Disclaimer (NFA & DYOR): OpenCatz AI is an open-source research and trading intelligence tool. Cryptocurrency markets carry inherent financial risks. Past performance does not guarantee future results. Not financial advice. Always do your own research.