# tristanodonnell/autonomous-trading-platform architecture

> Architecture diagram of the GitHub repository tristanodonnell/autonomous-trading-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tristanodonnell/autonomous-trading-platform
- Repository: https://github.com/tristanodonnell/autonomous-trading-platform

## Overview

The Autonomous Trading Platform carries market data and reproducible research through strategy validation, portfolio allocation, risk/governance, and order execution; one contract chain serves backtests, paper trading, and the currently disabled live mode. The frontend exposes dashboard, portfolio, strategy, experiment, controls, and settings workflows over backend endpoints. The graph preserves README-described capabilities where source excerpts were not sampled; those links represent documented flows, not inspected call sites. Sampled ingestion and query services support the ingestion, checkpoint, and dataset-state relationships shown.

Main entry points: [`src/autonomous_trading_platform/execution/services/order_execution_service.py`](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/execution/services/order_execution_service.py) (Order execution), [`src/autonomous_trading_platform/storage`](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/storage) (Market data store), [`src/autonomous_trading_platform/ingestion`](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/ingestion) (Data ingestion), [`src/autonomous_trading_platform/application/services`](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/application/services) (Experiment validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Operator experience"]
  node_frontend["Trading console<br/>[App.tsx]"]
  node_frontend_services["API services"]
  node_backend_api["Backend API"]
end

subgraph group_data["Market data"]
  node_ingestion["Data ingestion"]
  node_checkpoints["Ingestion checkpoints"]
  node_dataset_versions["Dataset lineage"]
  node_market_storage[("Market data store")]
end

subgraph group_research["Research and simulation"]
  node_features["Feature engineering"]
  node_strategies["Strategy research"]
  node_experiments["Experiment validation"]
  node_backtesting["Backtest and replay"]
end

subgraph group_governance["Governance and portfolio"]
  node_governance["Strategy governance"]
  node_allocation["Portfolio allocation"]
  node_risk["Risk and controls"]
end

subgraph group_runtime["Trading runtime"]
  node_execution["Order execution"]
  node_state_store[("System of record")]
  node_reporting["Portfolio reporting"]
end

node_operator(("Operator"))
node_market_provider["Market data provider"]
node_broker["Broker"]

node_operator -->|"uses"| node_frontend
node_frontend -->|"requests data"| node_frontend_services
node_frontend_services -->|"calls endpoints"| node_backend_api
node_market_provider -->|"provides bars"| node_ingestion
node_ingestion -->|"tracks progress"| node_checkpoints
node_ingestion -->|"writes market data"| node_market_storage
node_checkpoints -->|"persists checkpoints"| node_market_storage
node_dataset_versions -->|"queries lineage"| node_market_storage
node_market_storage -->|"supplies datasets"| node_features
node_features -->|"provides features"| node_strategies
node_strategies -->|"evaluates candidates"| node_experiments
node_experiments -->|"validates results"| node_backtesting
node_dataset_versions -->|"selects datasets"| node_experiments
node_backtesting -->|"reports performance"| node_governance
node_governance -->|"qualifies strategies"| node_allocation
node_allocation -->|"sets exposure"| node_risk
node_risk -->|"authorizes orders"| node_execution
node_execution -->|"submits orders"| node_broker
node_broker -->|"returns fills"| node_execution
node_execution -->|"records trades"| node_state_store
node_state_store -->|"supplies account state"| node_reporting
node_reporting -->|"serves metrics"| node_backend_api
node_execution -.->|"shares contracts"| node_backtesting

click node_frontend "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/frontend/src/App.tsx"
click node_frontend_services "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/frontend/src/services"
click node_backend_api "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/api"
click node_ingestion "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/ingestion"
click node_checkpoints "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/ingestion/market_data/services/incremental_ingestion_checkpoint_service.py"
click node_dataset_versions "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/runtime/services/dataset_version_query_service.py"
click node_market_storage "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/storage"
click node_features "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/feature_engineering"
click node_strategies "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform"
click node_experiments "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/application/services"
click node_backtesting "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/platform_backtest_service.py"
click node_governance "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/strategy_governance_service.py"
click node_allocation "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/portfolio/portfolio_engine.py"
click node_risk "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/drawdown_governance_service.py"
click node_execution "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/execution/services/order_execution_service.py"
click node_state_store "https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/storage/sor"
click node_reporting "https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/portfolio_analytics_service.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_frontend,node_frontend_services,node_backend_api toneBlue
class node_ingestion,node_checkpoints,node_dataset_versions,node_market_storage toneAmber
class node_features,node_strategies,node_experiments,node_backtesting toneMint
class node_governance,node_allocation,node_risk toneRose
class node_execution,node_state_store,node_reporting,node_operator,node_market_provider,node_broker toneIndigo
```

## Components

### Operator experience

- [Trading console](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API services](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/frontend/src/services): `frontend/src/services`
- [Backend API](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/api): `src/autonomous_trading_platform/api`

### Market data

- [Data ingestion](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/ingestion): `src/autonomous_trading_platform/ingestion`
- [Ingestion checkpoints](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/ingestion/market_data/services/incremental_ingestion_checkpoint_service.py): `src/autonomous_trading_platform/ingestion/market_data/services/incremental_ingestion_checkpoint_service.py`
- [Dataset lineage](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/runtime/services/dataset_version_query_service.py): `src/autonomous_trading_platform/runtime/services/dataset_version_query_service.py`
- [Market data store](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/storage): `src/autonomous_trading_platform/storage`

### Research and simulation

- [Feature engineering](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/feature_engineering): `src/autonomous_trading_platform/feature_engineering`
- [Strategy research](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform): `src/autonomous_trading_platform`
- [Experiment validation](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/application/services): `src/autonomous_trading_platform/application/services`
- [Backtest and replay](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/platform_backtest_service.py): `src/autonomous_trading_platform/application/services/platform_backtest_service.py`

### Governance and portfolio

- [Strategy governance](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/strategy_governance_service.py): `src/autonomous_trading_platform/application/services/strategy_governance_service.py`
- [Portfolio allocation](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/portfolio/portfolio_engine.py): `src/autonomous_trading_platform/portfolio/portfolio_engine.py`
- [Risk and controls](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/drawdown_governance_service.py): `src/autonomous_trading_platform/application/services/drawdown_governance_service.py`

### Trading runtime

- [Order execution](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/execution/services/order_execution_service.py): `src/autonomous_trading_platform/execution/services/order_execution_service.py`
- [System of record](https://github.com/tristanodonnell/autonomous-trading-platform/tree/main/src/autonomous_trading_platform/storage/sor): `src/autonomous_trading_platform/storage/sor`
- [Portfolio reporting](https://github.com/tristanodonnell/autonomous-trading-platform/blob/main/src/autonomous_trading_platform/application/services/portfolio_analytics_service.py): `src/autonomous_trading_platform/application/services/portfolio_analytics_service.py`

### Other components

- **Operator**
- **Market data provider**
- **Broker**

## Connections

- Operator → Trading console: uses
- Trading console → API services: requests data
- API services → Backend API: calls endpoints
- Market data provider → Data ingestion: provides bars
- Data ingestion → Ingestion checkpoints: tracks progress
- Data ingestion → Market data store: writes market data
- Ingestion checkpoints → Market data store: persists checkpoints
- Dataset lineage → Market data store: queries lineage
- Market data store → Feature engineering: supplies datasets
- Feature engineering → Strategy research: provides features
- Strategy research → Experiment validation: evaluates candidates
- Experiment validation → Backtest and replay: validates results
- Dataset lineage → Experiment validation: selects datasets
- Backtest and replay → Strategy governance: reports performance
- Strategy governance → Portfolio allocation: qualifies strategies
- Portfolio allocation → Risk and controls: sets exposure
- Risk and controls → Order execution: authorizes orders
- Order execution → Broker: submits orders
- Broker → Order execution: returns fills
- Order execution → System of record: records trades
- System of record → Portfolio reporting: supplies account state
- Portfolio reporting → Backend API: serves metrics
- Order execution → Backtest and replay: shares contracts