# krexibd/quant-trading architecture

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

- Interactive diagram: https://gitdiagram.com/krexibd/quant-trading
- Repository: https://github.com/krexibd/quant-trading

## Overview

Quant-trading is a collection of standalone Python research scripts, not a unified live-trading platform. Users run individual backtests or quantamental analyses against historical or project data; scripts generate signals, forecasts, portfolio analyses, or visualizations. The README describes technical-indicator and options strategies, statistical arbitrage, Monte Carlo analysis, commodity projects, and agricultural modeling. Several project capabilities are documented but not fully sampled, so their internal connections are not inferred.

Main entry points: [`quant-strategies/MACD Oscillator backtest.py`](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/MACD%20Oscillator%20backtest.py) (MACD Backtest), [`quant-strategies/Awesome Oscillator backtest.py`](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Awesome%20Oscillator%20backtest.py) (Awesome Oscillator), [`quant-strategies/Bollinger Bands Pattern Recognition backtest.py`](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Bollinger%20Bands%20Pattern%20Recognition%20backtest.py) (Bollinger Patterns), [`quant-strategies/Dual Thrust backtest.py`](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Dual%20Thrust%20backtest.py) (Dual Thrust)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_technical["Technical Strategies"]
  node_macd["MACD Backtest"]
  node_awesome["Awesome Oscillator"]
  node_bollinger["Bollinger Patterns"]
  node_dual["Dual Thrust"]
  node_heikin["Heikin-Ashi"]
  node_london["London Breakout"]
  node_parabolic["Parabolic SAR"]
  node_rsi["RSI Patterns"]
  node_shooting["Shooting Star"]
end

subgraph group_quant["Quant Research"]
  node_pair["Pair Trading"]
  node_options["Options Straddle"]
  node_vix["VIX Calculator<br/>[VIX Calculator.py]"]
  node_monte["Monte Carlo"]
end

subgraph group_commodities["Commodity Projects"]
  node_oiltrade["Oil Money Backtest"]
  node_oilcad["CAD Model<br/>[Oil Money CAD.py]"]
  node_oilcop["COP Model<br/>[Oil Money COP.py]"]
  node_oilnok["NOK Model<br/>[Oil Money NOK.py]"]
  node_oilrub["RUB Model<br/>[Oil Money RUB.py]"]
  node_oilcost["Oil Cost Curve"]
  node_oilmap["Oil Production Map"]
  node_oremap["Iron Ore Map"]
end

subgraph group_agri["Agricultural Modeling"]
  node_cleanse["Crop Data ETL<br/>[cleanse data.py]"]
  node_country["Country Selection"]
  node_consistency["Data Consistency"]
  node_demand["Demand Estimation<br/>[estimate demand.py]"]
  node_forecast["Production Forecast<br/>[forecast.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"runs backtest"| node_macd
node_researcher -->|"runs backtest"| node_awesome
node_researcher -->|"runs backtest"| node_bollinger
node_researcher -->|"runs backtest"| node_dual
node_researcher -->|"runs backtest"| node_heikin
node_researcher -->|"runs backtest"| node_london
node_researcher -->|"runs backtest"| node_parabolic
node_researcher -->|"runs backtest"| node_rsi
node_researcher -->|"runs backtest"| node_shooting
node_researcher -->|"runs analysis"| node_pair
node_researcher -->|"runs analysis"| node_options
node_researcher -->|"runs analysis"| node_vix
node_researcher -->|"runs simulation"| node_monte
node_researcher -->|"runs analysis"| node_oiltrade
node_researcher -->|"runs analysis"| node_oilcad
node_researcher -->|"runs analysis"| node_oilcop
node_researcher -->|"runs analysis"| node_oilnok
node_researcher -->|"runs analysis"| node_oilrub
node_researcher -->|"runs analysis"| node_oilcost
node_researcher -->|"runs analysis"| node_oilmap
node_researcher -->|"runs analysis"| node_oremap
node_researcher -->|"runs project"| node_cleanse
node_researcher -->|"runs project"| node_country
node_researcher -->|"runs project"| node_consistency
node_researcher -->|"runs project"| node_demand
node_researcher -->|"runs project"| node_forecast

click node_macd "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/MACD%20Oscillator%20backtest.py"
click node_awesome "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Awesome%20Oscillator%20backtest.py"
click node_bollinger "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Bollinger%20Bands%20Pattern%20Recognition%20backtest.py"
click node_dual "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Dual%20Thrust%20backtest.py"
click node_heikin "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Heikin-Ashi%20backtest.py"
click node_london "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/London%20Breakout%20backtest.py"
click node_parabolic "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Parabolic%20SAR%20backtest.py"
click node_rsi "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/RSI%20Pattern%20Recognition%20backtest.py"
click node_shooting "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Shooting%20Star%20backtest.py"
click node_pair "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Pair%20trading%20backtest.py"
click node_options "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Options%20Straddle%20backtest.py"
click node_vix "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/VIX%20Calculator.py"
click node_monte "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Monte%20Carlo%20project/Monte%20Carlo%20backtest.py"
click node_oiltrade "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20Trading%20backtest.py"
click node_oilcad "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20CAD.py"
click node_oilcop "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20COP.py"
click node_oilnok "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20NOK.py"
click node_oilrub "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20RUB.py"
click node_oilcost "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/oil%20production/oil%20production%20cost%20curve.py"
click node_oilmap "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/oil%20production/oil%20production%20choropleth.py"
click node_oremap "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Ore%20Money%20project/iron%20ore%20production/iron%20ore%20production%20bubble%20map.py"
click node_cleanse "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/cleanse%20data.py"
click node_country "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/country%20selection.py"
click node_consistency "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/check%20consistency.py"
click node_demand "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/estimate%20demand.py"
click node_forecast "https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/forecast.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_macd,node_awesome,node_bollinger,node_dual,node_heikin,node_london,node_parabolic,node_rsi,node_shooting toneBlue
class node_pair,node_options,node_vix,node_monte toneAmber
class node_oiltrade,node_oilcad,node_oilcop,node_oilnok,node_oilrub,node_oilcost,node_oilmap,node_oremap toneMint
class node_cleanse,node_country,node_consistency,node_demand,node_forecast toneRose
class node_researcher toneIndigo
```

## Components

### Technical Strategies

- [MACD Backtest](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/MACD%20Oscillator%20backtest.py): `quant-strategies/MACD Oscillator backtest.py`
- [Awesome Oscillator](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Awesome%20Oscillator%20backtest.py): `quant-strategies/Awesome Oscillator backtest.py`
- [Bollinger Patterns](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Bollinger%20Bands%20Pattern%20Recognition%20backtest.py): `quant-strategies/Bollinger Bands Pattern Recognition backtest.py`
- [Dual Thrust](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Dual%20Thrust%20backtest.py): `quant-strategies/Dual Thrust backtest.py`
- [Heikin-Ashi](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Heikin-Ashi%20backtest.py): `quant-strategies/Heikin-Ashi backtest.py`
- [London Breakout](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/London%20Breakout%20backtest.py): `quant-strategies/London Breakout backtest.py`
- [Parabolic SAR](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Parabolic%20SAR%20backtest.py): `quant-strategies/Parabolic SAR backtest.py`
- [RSI Patterns](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/RSI%20Pattern%20Recognition%20backtest.py): `quant-strategies/RSI Pattern Recognition backtest.py`
- [Shooting Star](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Shooting%20Star%20backtest.py): `quant-strategies/Shooting Star backtest.py`

### Quant Research

- [Pair Trading](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Pair%20trading%20backtest.py): `quant-strategies/Pair trading backtest.py`
- [Options Straddle](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Options%20Straddle%20backtest.py): `quant-strategies/Options Straddle backtest.py`
- [VIX Calculator](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/VIX%20Calculator.py): `quant-strategies/VIX Calculator.py`
- [Monte Carlo](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Monte%20Carlo%20project/Monte%20Carlo%20backtest.py): `quant-strategies/Monte Carlo project/Monte Carlo backtest.py`

### Commodity Projects

- [Oil Money Backtest](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20Trading%20backtest.py): `quant-strategies/Oil Money project/Oil Money Trading backtest.py`
- [CAD Model](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20CAD.py): `quant-strategies/Oil Money project/Oil Money CAD.py`
- [COP Model](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20COP.py): `quant-strategies/Oil Money project/Oil Money COP.py`
- [NOK Model](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20NOK.py): `quant-strategies/Oil Money project/Oil Money NOK.py`
- [RUB Model](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/Oil%20Money%20RUB.py): `quant-strategies/Oil Money project/Oil Money RUB.py`
- [Oil Cost Curve](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/oil%20production/oil%20production%20cost%20curve.py): `quant-strategies/Oil Money project/oil production/oil production cost curve.py`
- [Oil Production Map](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Oil%20Money%20project/oil%20production/oil%20production%20choropleth.py): `quant-strategies/Oil Money project/oil production/oil production choropleth.py`
- [Iron Ore Map](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Ore%20Money%20project/iron%20ore%20production/iron%20ore%20production%20bubble%20map.py): `quant-strategies/Ore Money project/iron ore production/iron ore production bubble map.py`

### Agricultural Modeling

- [Crop Data ETL](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/cleanse%20data.py): `quant-strategies/Smart Farmers project/cleanse data.py`
- [Country Selection](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/country%20selection.py): `quant-strategies/Smart Farmers project/country selection.py`
- [Data Consistency](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/check%20consistency.py): `quant-strategies/Smart Farmers project/check consistency.py`
- [Demand Estimation](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/estimate%20demand.py): `quant-strategies/Smart Farmers project/estimate demand.py`
- [Production Forecast](https://github.com/krexibd/quant-trading/blob/main/quant-strategies/Smart%20Farmers%20project/forecast.py): `quant-strategies/Smart Farmers project/forecast.py`

### Other components

- **Researcher**

## Connections

- Researcher → MACD Backtest: runs backtest (evidence: `README.md`)
- Researcher → Awesome Oscillator: runs backtest (evidence: `README.md`)
- Researcher → Bollinger Patterns: runs backtest (evidence: `README.md`)
- Researcher → Dual Thrust: runs backtest (evidence: `README.md`)
- Researcher → Heikin-Ashi: runs backtest (evidence: `README.md`)
- Researcher → London Breakout: runs backtest (evidence: `README.md`)
- Researcher → Parabolic SAR: runs backtest (evidence: `README.md`)
- Researcher → RSI Patterns: runs backtest (evidence: `README.md`)
- Researcher → Shooting Star: runs backtest (evidence: `README.md`)
- Researcher → Pair Trading: runs analysis (evidence: `README.md`)
- Researcher → Options Straddle: runs analysis (evidence: `README.md`)
- Researcher → VIX Calculator: runs analysis (evidence: `README.md`)
- Researcher → Monte Carlo: runs simulation (evidence: `README.md`)
- Researcher → Oil Money Backtest: runs analysis
- Researcher → CAD Model: runs analysis
- Researcher → COP Model: runs analysis
- Researcher → NOK Model: runs analysis
- Researcher → RUB Model: runs analysis
- Researcher → Oil Cost Curve: runs analysis
- Researcher → Oil Production Map: runs analysis
- Researcher → Iron Ore Map: runs analysis
- Researcher → Crop Data ETL: runs project
- Researcher → Country Selection: runs project
- Researcher → Data Consistency: runs project
- Researcher → Demand Estimation: runs project
- Researcher → Production Forecast: runs project
