# yecidcorzo/ai-trader architecture

> Architecture diagram of the GitHub repository yecidcorzo/ai-trader, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yecidcorzo/ai-trader
- Repository: https://github.com/yecidcorzo/ai-trader

## Overview

This is a FastAPI trading-analysis and simulated-trading backend. Its main user flow is HTTP requests into the application, which obtains public Binance candles, computes signals or backtests, and returns results; authenticated paper-trading routes separately manage accounts and simulated positions persisted in SQLite. The graph includes strategy, research, risk, and identity layers. Evidence is limited to the supplied excerpts, SOURCE INDEX references, and README (which is empty); unverified subsystem links are omitted.

Main entry points: [`backend/main.py`](https://github.com/yecidcorzo/ai-trader/blob/main/backend/main.py) (HTTP application), [`backend/services/advanced_strategy_backtest.py`](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/advanced_strategy_backtest.py) (Advanced simulation), [`backend/api/paper_routes.py`](https://github.com/yecidcorzo/ai-trader/blob/main/backend/api/paper_routes.py) (Paper routes), [`backend/services/multi_timeframe_analysis.py`](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/multi_timeframe_analysis.py) (Multi-timeframe)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["API application"]
  node_main["HTTP application<br/>[main.py]"]
  node_paper_api["Paper routes<br/>[paper_routes.py]"]
end

subgraph group_signals["Market and signals"]
  node_market["Market data<br/>[market_services.py]"]
  node_signal_validation["Signal validation"]
  node_multi_tf["Multi-timeframe"]
  node_ema_rsi["EMA RSI strategy"]
  node_advanced_strategy["Advanced strategy"]
  node_atr["ATR indicator<br/>[atr.py]"]
  node_ema["EMA indicator<br/>[ema.py]"]
  node_macd["MACD indicator<br/>[macd.py]"]
  node_rsi["RSI indicator<br/>[rsi.py]"]
  node_vwap["VWAP indicator<br/>[vwap.py]"]
end

subgraph group_research["Backtest research"]
  node_backtest["Backtest engine"]
  node_advanced_backtest["Advanced simulation"]
  node_research_tools["Robustness research"]
  node_review["Backtest review<br/>[backtest_review.py]"]
  node_acceptance["Strategy acceptance"]
end

subgraph group_paper["Paper trading"]
  node_account["Paper accounts<br/>[paper_account.py]"]
  node_execution["Trade execution<br/>[paper_execution.py]"]
  node_risk["Risk controls<br/>[risk_engine.py]"]
  node_reconciliation["Trade reconciliation"]
end

subgraph group_platform["Identity and storage"]
  node_auth["Authentication<br/>[dependencies.py]"]
  node_principal["Verified identity<br/>[principal.py]"]
  node_database["SQLite connection<br/>[database.py]"]
  node_repository["Trading repository"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_main
node_client -->|"manages paper trades"| node_paper_api
node_main -->|"fetches candles"| node_market
node_main -->|"validates history"| node_signal_validation
node_main -->|"runs analysis"| node_multi_tf
node_main -->|"evaluates strategy"| node_ema_rsi
node_main -->|"evaluates strategy"| node_advanced_strategy
node_main -->|"runs backtest"| node_backtest
node_main -->|"runs simulation"| node_advanced_backtest
node_main -->|"runs research"| node_research_tools
node_main -->|"reviews results"| node_review
node_main -->|"checks acceptance"| node_acceptance
node_multi_tf -->|"uses indicator"| node_ema
node_multi_tf -->|"uses indicator"| node_rsi
node_multi_tf -->|"uses indicator"| node_macd
node_multi_tf -->|"uses indicator"| node_vwap
node_multi_tf -->|"uses indicator"| node_atr
node_backtest -->|"calculates RSI"| node_rsi
node_advanced_backtest -->|"evaluates signals"| node_advanced_strategy
node_advanced_backtest -->|"reuses engine"| node_backtest
node_advanced_backtest -->|"calculates indicator"| node_rsi
node_advanced_backtest -->|"calculates indicator"| node_macd
node_advanced_backtest -->|"calculates indicator"| node_vwap
node_advanced_backtest -->|"calculates indicator"| node_atr
node_advanced_backtest -->|"calculates indicator"| node_ema
node_research_tools -->|"runs fold tests"| node_backtest
node_research_tools -->|"runs fold tests"| node_advanced_backtest
node_review -->|"evaluates results"| node_research_tools
node_paper_api -->|"requires identity"| node_auth
node_auth -->|"provides principal"| node_principal
node_paper_api -->|"gets connection"| node_database
node_paper_api -->|"creates accounts"| node_account
node_paper_api -->|"closes positions"| node_execution
node_paper_api -.->|"queries trades"| node_repository
node_execution -->|"persists trades"| node_repository
node_execution -->|"uses account service"| node_account
node_execution -->|"checks risk"| node_risk
node_execution -->|"reconciles positions"| node_reconciliation
node_repository -.->|"executes SQL"| node_database

click node_main "https://github.com/yecidcorzo/ai-trader/blob/main/backend/main.py"
click node_paper_api "https://github.com/yecidcorzo/ai-trader/blob/main/backend/api/paper_routes.py"
click node_market "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/market_services.py"
click node_signal_validation "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/signal_validation.py"
click node_multi_tf "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/multi_timeframe_analysis.py"
click node_ema_rsi "https://github.com/yecidcorzo/ai-trader/blob/main/backend/strategies/ema_rsi_strategy.py"
click node_advanced_strategy "https://github.com/yecidcorzo/ai-trader/blob/main/backend/strategies/advanced_strategy.py"
click node_atr "https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/atr.py"
click node_ema "https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/ema.py"
click node_macd "https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/macd.py"
click node_rsi "https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/rsi.py"
click node_vwap "https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/vwap.py"
click node_backtest "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/backtest_service.py"
click node_advanced_backtest "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/advanced_strategy_backtest.py"
click node_research_tools "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/backtest_research.py"
click node_review "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/backtest_review.py"
click node_acceptance "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/strategy_acceptance.py"
click node_account "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/paper_account.py"
click node_execution "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/paper_execution.py"
click node_risk "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/risk_engine.py"
click node_reconciliation "https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/paper_reconciliation.py"
click node_auth "https://github.com/yecidcorzo/ai-trader/blob/main/backend/security/dependencies.py"
click node_principal "https://github.com/yecidcorzo/ai-trader/blob/main/backend/security/principal.py"
click node_database "https://github.com/yecidcorzo/ai-trader/blob/main/backend/infrastructure/database.py"
click node_repository "https://github.com/yecidcorzo/ai-trader/blob/main/backend/repositories/paper_trading_repository.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_paper_api,node_client toneBlue
class node_market,node_signal_validation,node_multi_tf,node_ema_rsi,node_advanced_strategy,node_atr,node_ema,node_macd,node_rsi,node_vwap toneAmber
class node_backtest,node_advanced_backtest,node_research_tools,node_review,node_acceptance toneMint
class node_account,node_execution,node_risk,node_reconciliation toneRose
class node_auth,node_principal,node_database,node_repository toneIndigo
```

## Components

### API application

- [HTTP application](https://github.com/yecidcorzo/ai-trader/blob/main/backend/main.py): `backend/main.py`
- [Paper routes](https://github.com/yecidcorzo/ai-trader/blob/main/backend/api/paper_routes.py): `backend/api/paper_routes.py`

### Market and signals

- [Market data](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/market_services.py): `backend/services/market_services.py`
- [Signal validation](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/signal_validation.py): `backend/services/signal_validation.py`
- [Multi-timeframe](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/multi_timeframe_analysis.py): `backend/services/multi_timeframe_analysis.py`
- [EMA RSI strategy](https://github.com/yecidcorzo/ai-trader/blob/main/backend/strategies/ema_rsi_strategy.py): `backend/strategies/ema_rsi_strategy.py`
- [Advanced strategy](https://github.com/yecidcorzo/ai-trader/blob/main/backend/strategies/advanced_strategy.py): `backend/strategies/advanced_strategy.py`
- [ATR indicator](https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/atr.py): `backend/indicators/atr.py`
- [EMA indicator](https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/ema.py): `backend/indicators/ema.py`
- [MACD indicator](https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/macd.py): `backend/indicators/macd.py`
- [RSI indicator](https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/rsi.py): `backend/indicators/rsi.py`
- [VWAP indicator](https://github.com/yecidcorzo/ai-trader/blob/main/backend/indicators/vwap.py): `backend/indicators/vwap.py`

### Backtest research

- [Backtest engine](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/backtest_service.py): `backend/services/backtest_service.py`
- [Advanced simulation](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/advanced_strategy_backtest.py): `backend/services/advanced_strategy_backtest.py`
- [Robustness research](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/backtest_research.py): `backend/services/backtest_research.py`
- [Backtest review](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/backtest_review.py): `backend/services/backtest_review.py`
- [Strategy acceptance](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/strategy_acceptance.py): `backend/services/strategy_acceptance.py`

### Paper trading

- [Paper accounts](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/paper_account.py): `backend/services/paper_account.py`
- [Trade execution](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/paper_execution.py): `backend/services/paper_execution.py`
- [Risk controls](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/risk_engine.py): `backend/services/risk_engine.py`
- [Trade reconciliation](https://github.com/yecidcorzo/ai-trader/blob/main/backend/services/paper_reconciliation.py): `backend/services/paper_reconciliation.py`

### Identity and storage

- [Authentication](https://github.com/yecidcorzo/ai-trader/blob/main/backend/security/dependencies.py): `backend/security/dependencies.py`
- [Verified identity](https://github.com/yecidcorzo/ai-trader/blob/main/backend/security/principal.py): `backend/security/principal.py`
- [SQLite connection](https://github.com/yecidcorzo/ai-trader/blob/main/backend/infrastructure/database.py): `backend/infrastructure/database.py`
- [Trading repository](https://github.com/yecidcorzo/ai-trader/blob/main/backend/repositories/paper_trading_repository.py): `backend/repositories/paper_trading_repository.py`

### Other components

- **API client**

## Connections

- API client → HTTP application: sends requests (evidence: `backend/main.py`)
- API client → Paper routes: manages paper trades (evidence: `backend/api/paper_routes.py`)
- HTTP application → Market data: fetches candles (evidence: `backend/main.py`)
- HTTP application → Signal validation: validates history (evidence: `backend/main.py`)
- HTTP application → Multi-timeframe: runs analysis (evidence: `backend/main.py`)
- HTTP application → EMA RSI strategy: evaluates strategy (evidence: `backend/main.py`)
- HTTP application → Advanced strategy: evaluates strategy (evidence: `backend/main.py`)
- HTTP application → Backtest engine: runs backtest (evidence: `backend/main.py`)
- HTTP application → Advanced simulation: runs simulation (evidence: `backend/main.py`)
- HTTP application → Robustness research: runs research (evidence: `backend/main.py`)
- HTTP application → Backtest review: reviews results (evidence: `backend/main.py`)
- HTTP application → Strategy acceptance: checks acceptance (evidence: `backend/main.py`)
- Multi-timeframe → EMA indicator: uses indicator (evidence: `backend/services/multi_timeframe_analysis.py`)
- Multi-timeframe → RSI indicator: uses indicator (evidence: `backend/services/multi_timeframe_analysis.py`)
- Multi-timeframe → MACD indicator: uses indicator (evidence: `backend/services/multi_timeframe_analysis.py`)
- Multi-timeframe → VWAP indicator: uses indicator (evidence: `backend/services/multi_timeframe_analysis.py`)
- Multi-timeframe → ATR indicator: uses indicator (evidence: `backend/services/multi_timeframe_analysis.py`)
- Backtest engine → RSI indicator: calculates RSI (evidence: `backend/services/backtest_service.py`)
- Advanced simulation → Advanced strategy: evaluates signals (evidence: `backend/services/advanced_strategy_backtest.py`)
- Advanced simulation → Backtest engine: reuses engine (evidence: `backend/services/advanced_strategy_backtest.py`)
- Advanced simulation → RSI indicator: calculates indicator (evidence: `backend/services/advanced_strategy_backtest.py`)
- Advanced simulation → MACD indicator: calculates indicator (evidence: `backend/services/advanced_strategy_backtest.py`)
- Advanced simulation → VWAP indicator: calculates indicator (evidence: `backend/services/advanced_strategy_backtest.py`)
- Advanced simulation → ATR indicator: calculates indicator (evidence: `backend/services/advanced_strategy_backtest.py`)
- Advanced simulation → EMA indicator: calculates indicator (evidence: `backend/services/advanced_strategy_backtest.py`)
- Robustness research → Backtest engine: runs fold tests (evidence: `backend/services/backtest_research.py`)
- Robustness research → Advanced simulation: runs fold tests (evidence: `backend/services/backtest_research.py`)
- Backtest review → Robustness research: evaluates results (evidence: `backend/services/backtest_review.py`)
- Paper routes → Authentication: requires identity (evidence: `backend/api/paper_routes.py`)
- Authentication → Verified identity: provides principal (evidence: `backend/security/dependencies.py`)
- Paper routes → SQLite connection: gets connection (evidence: `backend/api/paper_routes.py`)
- Paper routes → Paper accounts: creates accounts (evidence: `backend/api/paper_routes.py`)
- Paper routes → Trade execution: closes positions (evidence: `backend/api/paper_routes.py`)
- Paper routes → Trading repository: queries trades
- Trade execution → Trading repository: persists trades (evidence: `backend/services/paper_execution.py`)
- Trade execution → Paper accounts: uses account service (evidence: `backend/services/paper_execution.py`)
- Trade execution → Risk controls: checks risk (evidence: `backend/services/paper_execution.py`)
- Trade execution → Trade reconciliation: reconciles positions (evidence: `backend/services/paper_execution.py`)
- Trading repository → SQLite connection: executes SQL
