# gaurav4vnit/algotrade-deltaexchange architecture

> Architecture diagram of the GitHub repository gaurav4vnit/algotrade-deltaexchange, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gaurav4vnit/algotrade-deltaexchange
- Repository: https://github.com/gaurav4vnit/algotrade-deltaexchange

## Overview

GENAI is a C++ Delta Exchange trading bot with backtest and live modes. The principal workflow starts at the CLI: it selects a mode and strategy, supplies historical or exchange price closes, evaluates signals, then either simulates trades and reports metrics or submits live orders. Backtests support synthetic and CSV price histories, fees, slippage, funding, leverage, and isolated margin. Live capabilities include fetching history, tickers and positions, and placing market or bracket orders. The README and excerpts establish these paths; several strategy implementations are represented from the tree and README/index, but their internals were not inspected.

Main entry points: [`src/main.cpp`](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/main.cpp) (Mode dispatcher), [`src/delta_exchange.cpp`](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/delta_exchange.cpp) (Delta API client), [`src/backtest.h`](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/backtest.h) (Backtest engine), [`src/strategy.h`](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategy.h) (Strategy interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and Modes"]
  node_main["Mode dispatcher<br/>[main.cpp]"]
  node_price_input["Price history input<br/>[main.cpp]"]
end

subgraph group_simulation["Backtesting"]
  node_backtester["Backtest engine<br/>[backtest.h]"]
  node_metrics["Backtest metrics<br/>[backtest.h]"]
end

subgraph group_strategies["Trading Strategies"]
  node_strategy_api["Strategy interface<br/>[strategy.h]"]
  node_sma["SMA crossover<br/>[sma_crossover.cpp]"]
  node_breakout["One-hour breakout"]
  node_leveraged_breakout["Leveraged breakout"]
  node_mean_reversion["Mean reversion<br/>[mean_reversion.cpp]"]
  node_leveraged_sma["Leveraged SMA"]
  node_scalping["Scalping strategy"]
end

subgraph group_exchange["Exchange Access"]
  node_delta["Delta API client<br/>[delta_exchange.cpp]"]
  node_http["HTTP transport<br/>[http_client.cpp]"]
  node_json["JSON parser<br/>[json_utils.h]"]
end

node_user(("CLI user"))
node_exchange_service(("Delta Exchange"))

node_user -->|"runs"| node_main
node_main -->|"loads prices"| node_price_input
node_main -->|"runs backtest"| node_backtester
node_backtester -->|"evaluates signals"| node_strategy_api
node_main -->|"selects strategy"| node_sma
node_main -->|"selects strategy"| node_breakout
node_main -->|"selects strategy"| node_leveraged_breakout
node_main -->|"selects strategy"| node_mean_reversion
node_main -->|"selects strategy"| node_leveraged_sma
node_main -->|"selects strategy"| node_scalping
node_backtester -->|"returns metrics"| node_metrics
node_main -->|"runs live mode"| node_delta
node_delta -->|"sends requests"| node_http
node_delta -->|"parses responses"| node_json
node_delta -->|"calls REST API"| node_exchange_service

click node_main "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/main.cpp"
click node_price_input "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/main.cpp"
click node_backtester "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/backtest.h"
click node_metrics "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/backtest.h"
click node_strategy_api "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategy.h"
click node_sma "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/sma_crossover.cpp"
click node_breakout "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/one_hour_breakout.cpp"
click node_leveraged_breakout "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/leveraged_breakout.cpp"
click node_mean_reversion "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/mean_reversion.cpp"
click node_leveraged_sma "https://github.com/gaurav4vnit/algotrade-deltaexchange/tree/main/src/strategies"
click node_scalping "https://github.com/gaurav4vnit/algotrade-deltaexchange/tree/main/src/strategies"
click node_delta "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/delta_exchange.cpp"
click node_http "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/http_client.cpp"
click node_json "https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/json_utils.h"

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_price_input,node_user toneBlue
class node_backtester,node_metrics toneAmber
class node_strategy_api,node_sma,node_breakout,node_leveraged_breakout,node_mean_reversion,node_leveraged_sma,node_scalping toneMint
class node_delta,node_http,node_json toneRose
class node_exchange_service toneIndigo
```

## Components

### CLI and Modes

- [Mode dispatcher](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/main.cpp): `src/main.cpp`
- [Price history input](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/main.cpp): `src/main.cpp`

### Backtesting

- [Backtest engine](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/backtest.h): `src/backtest.h`
- [Backtest metrics](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/backtest.h): `src/backtest.h`

### Trading Strategies

- [Strategy interface](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategy.h): `src/strategy.h`
- [SMA crossover](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/sma_crossover.cpp): `src/strategies/sma_crossover.cpp`
- [One-hour breakout](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/one_hour_breakout.cpp): `src/strategies/one_hour_breakout.cpp`
- [Leveraged breakout](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/leveraged_breakout.cpp): `src/strategies/leveraged_breakout.cpp`
- [Mean reversion](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/strategies/mean_reversion.cpp): `src/strategies/mean_reversion.cpp`
- [Leveraged SMA](https://github.com/gaurav4vnit/algotrade-deltaexchange/tree/main/src/strategies): `src/strategies`
- [Scalping strategy](https://github.com/gaurav4vnit/algotrade-deltaexchange/tree/main/src/strategies): `src/strategies`

### Exchange Access

- [Delta API client](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/delta_exchange.cpp): `src/delta_exchange.cpp`
- [HTTP transport](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/http_client.cpp): `src/http_client.cpp`
- [JSON parser](https://github.com/gaurav4vnit/algotrade-deltaexchange/blob/main/src/json_utils.h): `src/json_utils.h`

### Other components

- **CLI user**
- **Delta Exchange**

## Connections

- CLI user → Mode dispatcher: runs (evidence: `README.md`)
- Mode dispatcher → Price history input: loads prices (evidence: `src/main.cpp`)
- Mode dispatcher → Backtest engine: runs backtest (evidence: `src/main.cpp`)
- Backtest engine → Strategy interface: evaluates signals (evidence: `src/backtest.h`)
- Mode dispatcher → SMA crossover: selects strategy (evidence: `src/main.cpp`)
- Mode dispatcher → One-hour breakout: selects strategy (evidence: `src/main.cpp`)
- Mode dispatcher → Leveraged breakout: selects strategy (evidence: `src/main.cpp`)
- Mode dispatcher → Mean reversion: selects strategy (evidence: `src/main.cpp`)
- Mode dispatcher → Leveraged SMA: selects strategy (evidence: `src/main.cpp`)
- Mode dispatcher → Scalping strategy: selects strategy (evidence: `src/main.cpp`)
- Backtest engine → Backtest metrics: returns metrics (evidence: `src/backtest.h`)
- Mode dispatcher → Delta API client: runs live mode (evidence: `src/main.cpp`)
- Delta API client → HTTP transport: sends requests
- Delta API client → JSON parser: parses responses
- Delta API client → Delta Exchange: calls REST API (evidence: `README.md`)
