Circuit Framework is a crypto-native, multi-agent LLM research system for paper trading and market analysis. It addresses crypto market complexity by using specialized agents to analyze market structure, derivatives, sentiment, catalysts, and regimes. A deterministic risk engine approves or rejects trades, targeting researchers and power users for systematic LLM-driven strategy development in a risk-free environment.

How It Works

A fork of TradingAgents (Apache 2.0), it enhances the internal tradingagents package with crypto workflows. Distinct agents (market structure, derivatives, sentiment, catalyst, regime) operate on a shared CryptoMarketSnapshot. A Research Manager coordinates these agents, leading to a Trader that emits structured trade proposals. A Deterministic Risk Gate enforces sizing, clamping, and rejection rules before paper execution. Strategy variations are managed via YAML profiles, customizing prompts and risk knobs.

Quick Start & Requirements

Install via pip install -e ".[dev]". Requires LLM API keys (e.g., OpenAI, Google) set via environment variables (TRADINGAGENTS_LLM_PROVIDER). Supports programmatic execution (TradingAgentsGraph) and CLI commands (tradingagents crypto analyze BTC). Docker is available. Default paper DB: ~/.tradingagents/circuit/paper.db.

Highlighted Details

• Supports normalized crypto symbols (BTC, ETH, SOL-PERP, HYPE), with Hyperliquid perps using base asset as venue_symbol.
• Configurable YAML strategy profiles (e.g., balanced, momentum) share core infrastructure but differ in risk limits.
• Enforces structured proposals and risk rules for stale data, leverage, position clamping, and confidence.
• Market data sourced from Hyperliquid public API (https://api.hyperliquid.xyz/info).

Maintenance & Community

This project is a fork of TradingAgents by Tauric Research. The README does not list community channels or notable contributors/sponsorships.

Licensing & Compatibility

Licensed under Apache License 2.0, inherited from TradingAgents. This permissive license is suitable for commercial use and closed-source linking.

Limitations & Caveats

On-chain data requires a verified provider. Public API may lack liquidation fields. LLM outputs can be incorrect; the risk gate cannot anticipate all edge cases. Paper trading fills approximate real execution using mid-price plus slippage and fees, not actual exchange matching. Strictly for research, not financial advice.