AutoTrader: Multi-Agent Trading System

Copyright (C) 2024-2025 Chris R. (iAmGiG) | Licensed under AGPL-3.0 | See NOTICE

Powered by AgentEdge - Autonomous AI agents seeking trading edge

---

Disclaimer

THIS SOFTWARE IS FOR EDUCATIONAL AND RESEARCH PURPOSES ONLY.

• Not Financial Advice: This system does not provide financial, investment, or trading advice
• Use at Your Own Risk: Trading involves substantial risk of loss
• No Warranties: Provided "as-is" without guarantees of accuracy or profitability
• Past Performance: Historical results (36.6% return, 0.856 Sharpe) do not guarantee future performance

---

Overview

AutoTrader is a production-ready trading platform featuring a multi-agent AI architecture powered by Microsoft AutoGen. The system combines validated MACD+RSI strategies with human oversight for paper/live trading via Alpaca Markets.

Core Philosophy: Pure mathematical indicators + human decision making > complex LLM sentiment analysis

Backtested Performance

Results from validation experiments:

Metric	Single Stock (AAPL 2024)	Multi-Stock Average (2024-2025)
Sharpe Ratio	0.856	0.77
Total Return	12.6%	36.6% (20 months)
Win Rate	51.4%	-
Max Drawdown	-10.1%	-23.4% avg
Strategy	MACD(13/34/8) + RSI(14/30/70) voting	Same

Note: Past performance does not guarantee future results.

Production Status

Component	Status
VoterAgent	Production Ready
CLI Trade Assistant	Complete
Alpaca Integration	Operational
Position Management	Complete
Trading Cycle	Complete
ScannerAgent	In Development
RiskAgent	In Development
ExecutorAgent	In Development

---

Core Agents

VoterAgent (Production Ready)

Location: src/autogen_agents/voter_agent.py

• MACD Signal Generation: Optimized 13/34/8 Fibonacci parameters
• RSI Momentum Analysis: 14-period with 30/70 thresholds
• Consensus Voting: Strong signals when both indicators agree
• Validated Performance: 0.856 Sharpe ratio over 2024-2025

Agents in Development

• ScannerAgent: Market opportunity identification
• RiskAgent: Position sizing and risk management
• ExecutorAgent: Trade execution via Alpaca API
• TradingOrchestrator: Multi-agent coordination

---

Installation

# Python 3.10+ required
conda create -n AutoTrader python=3.10
conda activate AutoTrader
pip install -e .

Configuration

Create config/config.yaml with API credentials:

POLYGON_IO: "your_key"           # Required: Market data
ALPHA_VANTAGE_KEY: "your_key"    # Required: Fallback data
ALPACA_PAPER_API_KEY: "your_key" # Required: Paper trading
ALPACA_PAPER_SECRET: "your_key"  # Required: Paper trading
ALPACA_ENDPOINT: "https://paper-api.alpaca.markets/v2"

# Optional - VoterAgent uses pure math, no LLM required
OPEN_AI_KEY: "sk-..."

---

Quick Start

Interactive CLI

python main.py

# Example session:
> buy 10 AAPL              # Execute trade
> show portfolio           # View positions
> check my alerts          # Position alerts
> /schedule                # Scheduler management
> /help                    # All commands

Daemon Mode

python main.py --daemon

# Runs twice daily:
# - Morning: 9:20 AM ET (reconciliation)
# - Evening: 3:50 PM ET (review)

---

CLI Commands

Trading

Command	Description
buy SYMBOL QTY	Place buy order
sell SYMBOL QTY	Place sell order
cancel ORDER_ID	Cancel order

Information

Command	Description
show portfolio	Portfolio summary
show positions	Open positions with P&L
show orders	Order history
show account	Account details

Configuration

Command	Description
show timeframe	Current timeframe
set timeframe 1d	Change timeframe
show config-file	View YAML config
show watchlist	Scanner symbols

Workflow

Command	Description
morning-routine	Morning scan and analysis
evening-summary	End-of-day report
monitor	Watch positions for exits
forward-test start NAME	Start validation test

---

Project Structure

AutoTrader-AgentEdge/
├── src/
│   ├── autogen_agents/     # AI agents (AutoGen framework)
│   │   ├── voter_agent.py  # Production MACD+RSI voting
│   │   ├── base_agent.py   # Base agent class
│   │   └── ...             # Other agents (in development)
│   ├── trading/            # Trading infrastructure
│   │   ├── broker/         # Alpaca integration
│   │   ├── orders/         # Order management
│   │   ├── positions/      # Position tracking
│   │   └── scheduling/     # Daily routines
│   ├── data_sources/       # Market data
│   └── cli/                # CLI tools
├── config/                 # API credentials (local only)
├── config_defaults/        # Default YAML configs
├── docs/                   # Documentation
├── reports/                # Trading reports
└── tests/                  # Test suite

---

Documentation

Topic	Location
Architecture	docs/02_architecture/
Development	docs/04_development/
Design Decisions	docs/05_decisions/
Features	docs/06_features/
Testing	docs/07_testing/

---

Development

Testing

# Unit tests
python -m pytest tests/ -v

# Code quality
ruff check src/
black --check src/

# VoterAgent validation
python -c "from src.autogen_agents.voter_agent import VoterAgent; print('OK')"

Contributing

1. Pick an issue from GitHub Issues
2. Create a feature branch
3. Make changes following docs/05_decisions/
4. Submit PR to development branch

---

License

AGPL-3.0 - See LICENSE file for details.