TradeCouncil — Multi-Agent Options Alpha

TradeCouncil is an explainable multi-agent options trading system built for the Alpaca AI Trading Agents Hackathon. Instead of giving one LLM unrestricted control over a brokerage account, TradeCouncil separates market analysis, AI reasoning, contract selection, risk management, and execution into independent layers. Python first scans a watchlist using deterministic indicators such as trend, moving averages, RSI, momentum, and volatility. Only the strongest candidates are sent to Featherless AI, which helps conserve inference credits and reduces unnecessary LLM calls. For each candidate, a Bull Agent builds the strongest case for the trade while a Bear Agent challenges it with downside risks and conflicting signals. A CIO Judge then compares both arguments and chooses CALL, PUT, or NO TRADE with a confidence score and rationale. If a trade is proposed, deterministic code selects an options contract using factors such as expiration, strike, delta, bid/ask spread, liquidity, and open interest. A hard-coded Risk Sentinel then checks position size, confidence, maximum loss, order value, liquidity, and portfolio exposure. The AI cannot override a veto. Approved trades can be routed to Alpaca paper trading through the Alpaca execution layer. The dashboard exposes the full decision trail: quant screen, Bull and Bear reasoning, CIO decision, selected contract, risk result, and execution preview.