# jimtin/algorithmic_trading_bot architecture

> Architecture diagram of the GitHub repository jimtin/algorithmic_trading_bot, 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/jimtin/algorithmic_trading_bot
- Repository: https://github.com/jimtin/algorithmic_trading_bot

## Overview

This repository is a tutorial-oriented algorithmic trading bot, not a single standalone trading product. The runtime supports exchange access, technical indicators, strategy signals, order handling, visualization, and backtesting. The clearest principal workflow is market data into strategy analysis and signal generation, with exchange order execution; the sampled root entry point itself only demonstrates cancelling a Binance order. Several strategy and backtesting relationships are documented by the source index, but their full control flow was not sampled.

Main entry points: [`mt5_lib.py`](https://github.com/jimtin/algorithmic_trading_bot/blob/master/mt5_lib.py) (MetaTrader Access), [`indicator_lib.py`](https://github.com/jimtin/algorithmic_trading_bot/blob/master/indicator_lib.py) (Indicators), [`ema_cross_strategy.py`](https://github.com/jimtin/algorithmic_trading_bot/blob/master/ema_cross_strategy.py) (EMA Strategy), [`strategies/macd_crossover_strategy.py`](https://github.com/jimtin/algorithmic_trading_bot/blob/master/strategies/macd_crossover_strategy.py) (MACD Crossover)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_exchange["Exchange Access"]
  node_mt5["MetaTrader Access<br/>[mt5_lib.py]"]
  node_binance["Binance Access<br/>[binance_lib.py]"]
end

subgraph group_analysis["Analysis and Signals"]
  node_indicators["Indicators<br/>[indicator_lib.py]"]
  node_ema["EMA Strategy"]
  node_macd_cross["MACD Crossover"]
  node_macd_zero["MACD Zero Cross"]
end

subgraph group_trading["Trading and Backtests"]
  node_entry["Bot Entry<br/>[main.py]"]
  node_risk["Risk Helpers"]
  node_orders["Order Handling<br/>[make_trade.py]"]
  node_backtest["Backtesting Engine<br/>[backtest_lib.py]"]
  node_ema_backtest["EMA Backtest Strategy<br/>[ema_cross.py]"]
end

subgraph group_presentation["Visualization"]
  node_display["Charts and Displays<br/>[display_lib.py]"]
end

node_user(("Bot Operator"))

node_user -->|"runs"| node_entry
node_entry -->|"cancels order"| node_binance
node_macd_cross -->|"retrieves history"| node_mt5
node_macd_cross -->|"calculates signals"| node_indicators
node_macd_zero -->|"calculates zero cross"| node_indicators
node_ema -->|"uses market data"| node_mt5
node_ema -->|"uses indicators"| node_indicators
node_ema -->|"submits trades"| node_orders
node_risk -->|"queries trade data"| node_mt5
node_risk -->|"retrieves candles"| node_binance
node_orders -->|"sends orders"| node_mt5
node_backtest -->|"retrieves history"| node_mt5
node_backtest -.->|"uses strategy"| node_ema_backtest
node_indicators -->|"adds chart lines"| node_display

click node_entry "https://github.com/jimtin/algorithmic_trading_bot/blob/master/main.py"
click node_mt5 "https://github.com/jimtin/algorithmic_trading_bot/blob/master/mt5_lib.py"
click node_binance "https://github.com/jimtin/algorithmic_trading_bot/blob/master/binance_lib.py"
click node_indicators "https://github.com/jimtin/algorithmic_trading_bot/blob/master/indicator_lib.py"
click node_ema "https://github.com/jimtin/algorithmic_trading_bot/blob/master/ema_cross_strategy.py"
click node_macd_cross "https://github.com/jimtin/algorithmic_trading_bot/blob/master/strategies/macd_crossover_strategy.py"
click node_macd_zero "https://github.com/jimtin/algorithmic_trading_bot/blob/master/strategies/macd_zero_cross_strategy.py"
click node_risk "https://github.com/jimtin/algorithmic_trading_bot/blob/master/helper_functions.py"
click node_orders "https://github.com/jimtin/algorithmic_trading_bot/blob/master/make_trade.py"
click node_backtest "https://github.com/jimtin/algorithmic_trading_bot/blob/master/backtest_lib.py"
click node_ema_backtest "https://github.com/jimtin/algorithmic_trading_bot/blob/master/backtesting_py_strategies/ema_cross.py"
click node_display "https://github.com/jimtin/algorithmic_trading_bot/blob/master/display_lib.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_mt5,node_binance toneBlue
class node_indicators,node_ema,node_macd_cross,node_macd_zero toneAmber
class node_entry,node_risk,node_orders,node_backtest,node_ema_backtest toneMint
class node_display toneRose
class node_user toneIndigo
```

## Components

### Exchange Access

- [MetaTrader Access](https://github.com/jimtin/algorithmic_trading_bot/blob/master/mt5_lib.py): `mt5_lib.py`
- [Binance Access](https://github.com/jimtin/algorithmic_trading_bot/blob/master/binance_lib.py): `binance_lib.py`

### Analysis and Signals

- [Indicators](https://github.com/jimtin/algorithmic_trading_bot/blob/master/indicator_lib.py): `indicator_lib.py`
- [EMA Strategy](https://github.com/jimtin/algorithmic_trading_bot/blob/master/ema_cross_strategy.py): `ema_cross_strategy.py`
- [MACD Crossover](https://github.com/jimtin/algorithmic_trading_bot/blob/master/strategies/macd_crossover_strategy.py): `strategies/macd_crossover_strategy.py`
- [MACD Zero Cross](https://github.com/jimtin/algorithmic_trading_bot/blob/master/strategies/macd_zero_cross_strategy.py): `strategies/macd_zero_cross_strategy.py`

### Trading and Backtests

- [Bot Entry](https://github.com/jimtin/algorithmic_trading_bot/blob/master/main.py): `main.py`
- [Risk Helpers](https://github.com/jimtin/algorithmic_trading_bot/blob/master/helper_functions.py): `helper_functions.py`
- [Order Handling](https://github.com/jimtin/algorithmic_trading_bot/blob/master/make_trade.py): `make_trade.py`
- [Backtesting Engine](https://github.com/jimtin/algorithmic_trading_bot/blob/master/backtest_lib.py): `backtest_lib.py`
- [EMA Backtest Strategy](https://github.com/jimtin/algorithmic_trading_bot/blob/master/backtesting_py_strategies/ema_cross.py): `backtesting_py_strategies/ema_cross.py`

### Visualization

- [Charts and Displays](https://github.com/jimtin/algorithmic_trading_bot/blob/master/display_lib.py): `display_lib.py`

### Other components

- **Bot Operator**

## Connections

- Bot Operator → Bot Entry: runs (evidence: `main.py`)
- Bot Entry → Binance Access: cancels order (evidence: `main.py`)
- MACD Crossover → MetaTrader Access: retrieves history (evidence: `strategies/macd_crossover_strategy.py`)
- MACD Crossover → Indicators: calculates signals (evidence: `strategies/macd_crossover_strategy.py`)
- MACD Zero Cross → Indicators: calculates zero cross (evidence: `strategies/macd_zero_cross_strategy.py`)
- EMA Strategy → MetaTrader Access: uses market data (evidence: `ema_cross_strategy.py`)
- EMA Strategy → Indicators: uses indicators (evidence: `ema_cross_strategy.py`)
- EMA Strategy → Order Handling: submits trades (evidence: `ema_cross_strategy.py`)
- Risk Helpers → MetaTrader Access: queries trade data (evidence: `helper_functions.py`)
- Risk Helpers → Binance Access: retrieves candles (evidence: `helper_functions.py`)
- Order Handling → MetaTrader Access: sends orders (evidence: `make_trade.py`)
- Backtesting Engine → MetaTrader Access: retrieves history (evidence: `backtest_lib.py`)
- Backtesting Engine → EMA Backtest Strategy: uses strategy (evidence: `backtest_lib.py`)
- Indicators → Charts and Displays: adds chart lines (evidence: `indicator_lib.py`)
