EthanXiang777/circuit-framework

What it solves

Circuit Framework provides a structured way to conduct cryptocurrency research and paper trading using a multi-agent AI system. It solves the problem of fragmented market analysis by coordinating specialized AI agents to evaluate market structure, sentiment, and catalysts before passing a trade proposal to a deterministic risk engine that ensures safety and discipline.

How it works

The system uses a pipeline of specialized AI analysts that all operate on a single immutable snapshot of market data. The process follows a specific sequence:

1. Analysis: Agents focused on Market Structure, Derivatives, Sentiment, Catalysts, and Market Regime analyze the data.
2. Debate: Bull and Bear researchers debate the findings, which are then synthesized by a Research Manager.
3. Proposal: A Trader agent generates a structured trade proposal (Long, Short, or No Trade).
4. Risk Gate: A deterministic (non-AI) risk engine checks the proposal against strict rules (e.g., stop-loss, leverage limits, and data freshness) to approve or reject the trade.
5. Execution: Approved trades are recorded in a local SQLite database for paper trading simulation.

Who it’s for

This framework is designed for researchers and traders interested in testing AI-driven trading strategies in the crypto market without risking real capital.

Highlights

• Deterministic Risk Control: Uses a hard-coded risk gate to prevent AI hallucinations from executing unsafe trades.
• Multi-Agent Debate: Employs a competitive research process (Bull vs. Bear) to refine trade theses.
• Crypto-Native Data: Integrates with Hyperliquid public API for candles, order books, and funding history.
• Strategy Profiles: Includes pre-defined YAML profiles for different styles, such as momentum, mean reversion, and macro regime.