# kevin-sodhi/quantedge-ai architecture

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

- Interactive diagram: https://gitdiagram.com/kevin-sodhi/quantedge-ai
- Repository: https://github.com/kevin-sodhi/quantedge-ai

## Overview

QuantEdge is a browser-based trading research platform. Users choose a ticker, date range and strategy; Python fetches and normalizes market data, then coordinates standard backtests through Java or executes generated custom strategies in an isolated Python sandbox. Results include charts, signals and performance metrics; walk-forward validation separately evaluates optimized parameters on held-out data. The README documents AI strategy parsing/generation and market-data integration, but the supplied source excerpts do not show those request handlers in detail, so those links rely on README evidence.

Main entry points: [`quantedge-react/src/pages/Backtest.jsx`](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/pages/Backtest.jsx) (Backtest Dashboard), [`algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java) (Backtest Service), [`algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java`](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java) (Backtest Engine), [`quantedge-python/main.py`](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/main.py) (FastAPI Orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Research UI"]
  node_react["React App<br/>[App.jsx]"]
  node_backtest_page["Backtest Dashboard<br/>[Backtest.jsx]"]
  node_strategy_page["Strategy Builder<br/>[Strategies.jsx]"]
  node_form["Backtest Form<br/>[BacktestForm.jsx]"]
  node_chart["Chart &amp; Signals"]
  node_metrics_ui["Metrics View<br/>[MetricsTable.jsx]"]
  node_wf_ui["Walk-Forward View"]
end

subgraph group_api["Python API"]
  node_python_api["FastAPI Orchestrator<br/>[main.py]"]
  node_market_data["Market Data Service<br/>[data_service.py]"]
end

subgraph group_java["Java Backtesting"]
  node_java_controller["Backtest API"]
  node_java_service["Backtest Service"]
  node_engine["Backtest Engine"]
  node_walkforward["Walk-Forward Validator"]
  node_metrics["Metrics Calculator"]
  node_results["Result Collection"]
end

subgraph group_domain["Trading Domain"]
  node_indicators["Technical Indicators"]
  node_strategies["Built-in Strategies"]
  node_portfolio["Portfolio &amp; Trades<br/>[Portfolio.java]"]
  node_candles["Candle Data<br/>[Candle.java]"]
end

subgraph group_custom["AI Custom Strategies"]
  node_custom_builder["AI Strategy Builder<br/>[main.py]"]
  node_sandbox["Code Sandbox"]
  node_python_metrics["Python Metrics"]
end

node_browser(("Researcher"))
node_twelve_data[("Twelve Data")]
node_claude{{"Claude API"}}

node_browser -->|"uses"| node_react
node_react -->|"routes to"| node_backtest_page
node_react -->|"routes to"| node_strategy_page
node_backtest_page -->|"renders"| node_form
node_backtest_page -->|"renders"| node_chart
node_backtest_page -->|"renders"| node_metrics_ui
node_backtest_page -->|"renders"| node_wf_ui
node_backtest_page -->|"posts requests"| node_python_api
node_strategy_page -->|"posts requests"| node_python_api
node_python_api -->|"uses"| node_market_data
node_market_data -->|"fetches OHLCV"| node_twelve_data
node_python_api -->|"forwards backtests"| node_java_controller
node_java_controller -->|"delegates to"| node_java_service
node_java_service -->|"converts input"| node_candles
node_java_service -->|"runs"| node_engine
node_java_service -->|"runs validation"| node_walkforward
node_java_service -->|"computes"| node_metrics
node_java_service -->|"registers collector"| node_results
node_engine -->|"updates"| node_indicators
node_engine -->|"requests signals"| node_strategies
node_engine -->|"applies trades"| node_portfolio
node_engine -->|"notifies"| node_results
node_python_api -->|"routes custom mode"| node_custom_builder
node_custom_builder -->|"requests strategy code"| node_claude
node_custom_builder -->|"executes generated code"| node_sandbox
node_sandbox -->|"returns signals"| node_python_metrics

click node_react "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/App.jsx"
click node_backtest_page "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/pages/Backtest.jsx"
click node_strategy_page "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/pages/Strategies.jsx"
click node_form "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/BacktestForm.jsx"
click node_chart "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/CandlestickChart.jsx"
click node_metrics_ui "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/MetricsTable.jsx"
click node_wf_ui "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/WalkForwardResults.jsx"
click node_python_api "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/main.py"
click node_market_data "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/services/data_service.py"
click node_java_controller "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestController.java"
click node_java_service "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java"
click node_engine "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java"
click node_walkforward "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/WalkForwardValidator.java"
click node_metrics "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/MetricsCalculator.java"
click node_results "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/ResultCollector.java"
click node_indicators "https://github.com/kevin-sodhi/quantedge-ai/tree/main/algo-backtester-java/src/main/java/com/kevin/algo/indicators"
click node_strategies "https://github.com/kevin-sodhi/quantedge-ai/tree/main/algo-backtester-java/src/main/java/com/kevin/algo/strategy"
click node_portfolio "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/portfolio/Portfolio.java"
click node_candles "https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/core/Candle.java"
click node_custom_builder "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/main.py"
click node_sandbox "https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/services/sandbox_executor.py"
click node_python_metrics "https://github.com/kevin-sodhi/quantedge-ai/tree/main/quantedge-python"

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_react,node_backtest_page,node_strategy_page,node_form,node_chart,node_metrics_ui,node_wf_ui toneBlue
class node_python_api,node_market_data,node_twelve_data toneAmber
class node_java_controller,node_java_service,node_engine,node_walkforward,node_metrics,node_results,node_claude toneMint
class node_indicators,node_strategies,node_portfolio,node_candles toneRose
class node_custom_builder,node_sandbox,node_python_metrics,node_browser toneIndigo
```

## Components

### Research UI

- [React App](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/App.jsx): `quantedge-react/src/App.jsx`
- [Backtest Dashboard](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/pages/Backtest.jsx): `quantedge-react/src/pages/Backtest.jsx`
- [Strategy Builder](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/pages/Strategies.jsx): `quantedge-react/src/pages/Strategies.jsx`
- [Backtest Form](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/BacktestForm.jsx): `quantedge-react/src/components/BacktestForm.jsx`
- [Chart & Signals](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/CandlestickChart.jsx): `quantedge-react/src/components/CandlestickChart.jsx`
- [Metrics View](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/MetricsTable.jsx): `quantedge-react/src/components/MetricsTable.jsx`
- [Walk-Forward View](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-react/src/components/WalkForwardResults.jsx): `quantedge-react/src/components/WalkForwardResults.jsx`

### Python API

- [FastAPI Orchestrator](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/main.py): `quantedge-python/main.py`
- [Market Data Service](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/services/data_service.py): `quantedge-python/services/data_service.py`

### Java Backtesting

- [Backtest API](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestController.java): `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestController.java`
- [Backtest Service](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java): `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`
- [Backtest Engine](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java): `algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java`
- [Walk-Forward Validator](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/WalkForwardValidator.java): `algo-backtester-java/src/main/java/com/kevin/algo/engine/WalkForwardValidator.java`
- [Metrics Calculator](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/MetricsCalculator.java): `algo-backtester-java/src/main/java/com/kevin/algo/engine/MetricsCalculator.java`
- [Result Collection](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/engine/ResultCollector.java): `algo-backtester-java/src/main/java/com/kevin/algo/engine/ResultCollector.java`

### Trading Domain

- [Technical Indicators](https://github.com/kevin-sodhi/quantedge-ai/tree/main/algo-backtester-java/src/main/java/com/kevin/algo/indicators): `algo-backtester-java/src/main/java/com/kevin/algo/indicators`
- [Built-in Strategies](https://github.com/kevin-sodhi/quantedge-ai/tree/main/algo-backtester-java/src/main/java/com/kevin/algo/strategy): `algo-backtester-java/src/main/java/com/kevin/algo/strategy`
- [Portfolio & Trades](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/portfolio/Portfolio.java): `algo-backtester-java/src/main/java/com/kevin/algo/portfolio/Portfolio.java`
- [Candle Data](https://github.com/kevin-sodhi/quantedge-ai/blob/main/algo-backtester-java/src/main/java/com/kevin/algo/core/Candle.java): `algo-backtester-java/src/main/java/com/kevin/algo/core/Candle.java`

### AI Custom Strategies

- [AI Strategy Builder](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/main.py): `quantedge-python/main.py`
- [Code Sandbox](https://github.com/kevin-sodhi/quantedge-ai/blob/main/quantedge-python/services/sandbox_executor.py): `quantedge-python/services/sandbox_executor.py`
- [Python Metrics](https://github.com/kevin-sodhi/quantedge-ai/tree/main/quantedge-python): `quantedge-python`

### Other components

- **Researcher**
- **Twelve Data**
- **Claude API**

## Connections

- Researcher → React App: uses
- React App → Backtest Dashboard: routes to (evidence: `quantedge-react/src/App.jsx`)
- React App → Strategy Builder: routes to (evidence: `quantedge-react/src/App.jsx`)
- Backtest Dashboard → Backtest Form: renders (evidence: `quantedge-react/src/pages/Backtest.jsx`)
- Backtest Dashboard → Chart & Signals: renders (evidence: `quantedge-react/src/pages/Backtest.jsx`)
- Backtest Dashboard → Metrics View: renders (evidence: `quantedge-react/src/pages/Backtest.jsx`)
- Backtest Dashboard → Walk-Forward View: renders (evidence: `quantedge-react/src/pages/Backtest.jsx`)
- Backtest Dashboard → FastAPI Orchestrator: posts requests (evidence: `quantedge-react/src/pages/Backtest.jsx`)
- Strategy Builder → FastAPI Orchestrator: posts requests
- FastAPI Orchestrator → Market Data Service: uses (evidence: `quantedge-python/main.py`)
- Market Data Service → Twelve Data: fetches OHLCV
- FastAPI Orchestrator → Backtest API: forwards backtests
- Backtest API → Backtest Service: delegates to (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestController.java`)
- Backtest Service → Candle Data: converts input (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`)
- Backtest Service → Backtest Engine: runs (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`)
- Backtest Service → Walk-Forward Validator: runs validation (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`)
- Backtest Service → Metrics Calculator: computes (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`)
- Backtest Service → Result Collection: registers collector (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/web/BacktestService.java`)
- Backtest Engine → Technical Indicators: updates (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java`)
- Backtest Engine → Built-in Strategies: requests signals (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java`)
- Backtest Engine → Portfolio & Trades: applies trades (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java`)
- Backtest Engine → Result Collection: notifies (evidence: `algo-backtester-java/src/main/java/com/kevin/algo/engine/BacktestEngine.java`)
- FastAPI Orchestrator → AI Strategy Builder: routes custom mode (evidence: `quantedge-python/main.py`)
- AI Strategy Builder → Claude API: requests strategy code
- AI Strategy Builder → Code Sandbox: executes generated code (evidence: `quantedge-python/main.py`)
- Code Sandbox → Python Metrics: returns signals (evidence: `quantedge-python/main.py`)
