# frede43/smc_concept architecture

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

- Interactive diagram: https://gitdiagram.com/frede43/smc_concept
- Repository: https://github.com/frede43/smc_concept

## Overview

This is an automated Smart Money Concepts trading bot for MetaTrader 5, with demo/live operation and a separate backtesting capability. In the principal workflow, the bot entry point obtains market data, applies the SMC strategy and trading filters, manages risk, then sends orders through the broker connector. Separate branches cover economic-news and market-context analysis, historical simulation, and trade/performance monitoring. Edges reflect the sampled source and SOURCE INDEX; several monitoring and analysis capabilities are represented from the tree, but their runtime wiring is not established by the excerpts.

Main entry points: [`main.py`](https://github.com/frede43/smc_concept/blob/main/main.py) (Bot entry point), [`strategy/smc_strategy.py`](https://github.com/frede43/smc_concept/blob/main/strategy/smc_strategy.py) (SMC strategy), [`broker/mt5_connector.py`](https://github.com/frede43/smc_concept/blob/main/broker/mt5_connector.py) (MT5 connector), [`strategy/news_filter.py`](https://github.com/frede43/smc_concept/blob/main/strategy/news_filter.py) (Economic news filter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Trading runtime"]
  node_main["Bot entry point<br/>[main.py]"]
  node_market["MT5 connector<br/>[mt5_connector.py]"]
end

subgraph group_analysis["Signal analysis"]
  node_strategy["SMC strategy<br/>[smc_strategy.py]"]
  node_filters["Strategy filters<br/>[filters.py]"]
  node_killzones["Session killzones<br/>[killzones.py]"]
  node_smc["SMC structures"]
  node_advanced["Signal scoring"]
  node_fvg["Fair value gaps<br/>[fair_value_gap.py]"]
  node_micro["Micro timing<br/>[micro_timing.py]"]
  node_fundamentals["Market context"]
  node_news["Economic news filter<br/>[news_filter.py]"]
  node_newsdata["News data fetcher<br/>[news_fetcher.py]"]
  node_myfxbook["Myfxbook data"]
end

subgraph group_simulation["Backtesting"]
  node_backtester["Backtest engine<br/>[backtester.py]"]
  node_montecarlo["Monte Carlo analysis<br/>[monte_carlo.py]"]
  node_walkforward["Walk-forward analysis<br/>[walk_forward.py]"]
end

subgraph group_operations["Risk and execution"]
  node_risk["Risk management<br/>[risk_management.py]"]
  node_antitilt["Anti-tilt controls<br/>[anti_tilt.py]"]
  node_orders["Order manager<br/>[order_manager.py]"]
end

subgraph group_monitoring["Monitoring and records"]
  node_trade_monitor["Trade monitor<br/>[trade_monitor.py]"]
  node_journal[("Trade journal<br/>[trade_journal.py]")]
  node_sessions[("Session analytics<br/>[session_tracker.py]")]
  node_correlation["Correlation guard"]
  node_dashboard["Live dashboard<br/>[dashboard.py]"]
end

node_trader(("Trader"))

node_trader -->|"starts"| node_main
node_main -->|"connects through"| node_market
node_main -->|"uses"| node_strategy
node_main -->|"uses"| node_risk
node_main -->|"checks"| node_news
node_main -->|"monitors trades"| node_trade_monitor
node_main -->|"records trades"| node_journal
node_main -->|"records sessions"| node_sessions
node_main -->|"checks exposure"| node_correlation
node_strategy -->|"uses"| node_smc
node_strategy -->|"uses"| node_fvg
node_strategy -->|"scores signals"| node_advanced
node_strategy -->|"uses"| node_killzones
node_strategy -->|"uses"| node_micro
node_filters -->|"checks sessions"| node_killzones
node_fundamentals -->|"fetches news"| node_newsdata
node_fundamentals -->|"uses"| node_news
node_news -->|"fetches data"| node_myfxbook
node_risk -->|"uses controls"| node_antitilt
node_market -->|"initializes"| node_orders
node_trade_monitor -->|"manages positions"| node_orders
node_backtester -->|"downloads data"| node_market
node_backtester -->|"simulates"| node_strategy
node_dashboard -->|"reads stats"| node_sessions
node_dashboard -->|"uses"| node_correlation

click node_main "https://github.com/frede43/smc_concept/blob/main/main.py"
click node_market "https://github.com/frede43/smc_concept/blob/main/broker/mt5_connector.py"
click node_strategy "https://github.com/frede43/smc_concept/blob/main/strategy/smc_strategy.py"
click node_filters "https://github.com/frede43/smc_concept/blob/main/strategy/filters.py"
click node_killzones "https://github.com/frede43/smc_concept/blob/main/core/killzones.py"
click node_smc "https://github.com/frede43/smc_concept/blob/main/core/market_structure.py"
click node_advanced "https://github.com/frede43/smc_concept/blob/main/core/advanced_filters.py"
click node_fvg "https://github.com/frede43/smc_concept/blob/main/core/fair_value_gap.py"
click node_micro "https://github.com/frede43/smc_concept/blob/main/core/micro_timing.py"
click node_fundamentals "https://github.com/frede43/smc_concept/blob/main/core/fundamental_filter.py"
click node_news "https://github.com/frede43/smc_concept/blob/main/strategy/news_filter.py"
click node_risk "https://github.com/frede43/smc_concept/blob/main/strategy/risk_management.py"
click node_antitilt "https://github.com/frede43/smc_concept/blob/main/strategy/anti_tilt.py"
click node_orders "https://github.com/frede43/smc_concept/blob/main/broker/order_manager.py"
click node_backtester "https://github.com/frede43/smc_concept/blob/main/backtest/backtester.py"
click node_montecarlo "https://github.com/frede43/smc_concept/blob/main/backtest/monte_carlo.py"
click node_walkforward "https://github.com/frede43/smc_concept/blob/main/backtest/walk_forward.py"
click node_trade_monitor "https://github.com/frede43/smc_concept/blob/main/strategy/trade_monitor.py"
click node_journal "https://github.com/frede43/smc_concept/blob/main/utils/trade_journal.py"
click node_sessions "https://github.com/frede43/smc_concept/blob/main/utils/session_tracker.py"
click node_correlation "https://github.com/frede43/smc_concept/blob/main/utils/correlation_guard.py"
click node_dashboard "https://github.com/frede43/smc_concept/blob/main/utils/dashboard.py"
click node_newsdata "https://github.com/frede43/smc_concept/blob/main/utils/news_fetcher.py"
click node_myfxbook "https://github.com/frede43/smc_concept/blob/main/utils/myfxbook_fetcher.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_main,node_market toneBlue
class node_strategy,node_filters,node_killzones,node_smc,node_advanced,node_fvg,node_micro,node_fundamentals,node_news,node_newsdata,node_myfxbook toneAmber
class node_backtester,node_montecarlo,node_walkforward toneMint
class node_risk,node_antitilt,node_orders toneRose
class node_trade_monitor,node_journal,node_sessions,node_correlation,node_dashboard,node_trader toneIndigo
```

## Components

### Trading runtime

- [Bot entry point](https://github.com/frede43/smc_concept/blob/main/main.py): `main.py`
- [MT5 connector](https://github.com/frede43/smc_concept/blob/main/broker/mt5_connector.py): `broker/mt5_connector.py`

### Signal analysis

- [SMC strategy](https://github.com/frede43/smc_concept/blob/main/strategy/smc_strategy.py): `strategy/smc_strategy.py`
- [Strategy filters](https://github.com/frede43/smc_concept/blob/main/strategy/filters.py): `strategy/filters.py`
- [Session killzones](https://github.com/frede43/smc_concept/blob/main/core/killzones.py): `core/killzones.py`
- [SMC structures](https://github.com/frede43/smc_concept/blob/main/core/market_structure.py): `core/market_structure.py`
- [Signal scoring](https://github.com/frede43/smc_concept/blob/main/core/advanced_filters.py): `core/advanced_filters.py`
- [Fair value gaps](https://github.com/frede43/smc_concept/blob/main/core/fair_value_gap.py): `core/fair_value_gap.py`
- [Micro timing](https://github.com/frede43/smc_concept/blob/main/core/micro_timing.py): `core/micro_timing.py`
- [Market context](https://github.com/frede43/smc_concept/blob/main/core/fundamental_filter.py): `core/fundamental_filter.py`
- [Economic news filter](https://github.com/frede43/smc_concept/blob/main/strategy/news_filter.py): `strategy/news_filter.py`
- [News data fetcher](https://github.com/frede43/smc_concept/blob/main/utils/news_fetcher.py): `utils/news_fetcher.py`
- [Myfxbook data](https://github.com/frede43/smc_concept/blob/main/utils/myfxbook_fetcher.py): `utils/myfxbook_fetcher.py`

### Backtesting

- [Backtest engine](https://github.com/frede43/smc_concept/blob/main/backtest/backtester.py): `backtest/backtester.py`
- [Monte Carlo analysis](https://github.com/frede43/smc_concept/blob/main/backtest/monte_carlo.py): `backtest/monte_carlo.py`
- [Walk-forward analysis](https://github.com/frede43/smc_concept/blob/main/backtest/walk_forward.py): `backtest/walk_forward.py`

### Risk and execution

- [Risk management](https://github.com/frede43/smc_concept/blob/main/strategy/risk_management.py): `strategy/risk_management.py`
- [Anti-tilt controls](https://github.com/frede43/smc_concept/blob/main/strategy/anti_tilt.py): `strategy/anti_tilt.py`
- [Order manager](https://github.com/frede43/smc_concept/blob/main/broker/order_manager.py): `broker/order_manager.py`

### Monitoring and records

- [Trade monitor](https://github.com/frede43/smc_concept/blob/main/strategy/trade_monitor.py): `strategy/trade_monitor.py`
- [Trade journal](https://github.com/frede43/smc_concept/blob/main/utils/trade_journal.py): `utils/trade_journal.py`
- [Session analytics](https://github.com/frede43/smc_concept/blob/main/utils/session_tracker.py): `utils/session_tracker.py`
- [Correlation guard](https://github.com/frede43/smc_concept/blob/main/utils/correlation_guard.py): `utils/correlation_guard.py`
- [Live dashboard](https://github.com/frede43/smc_concept/blob/main/utils/dashboard.py): `utils/dashboard.py`

### Other components

- **Trader**

## Connections

- Trader → Bot entry point: starts (evidence: `main.py`)
- Bot entry point → MT5 connector: connects through (evidence: `main.py`)
- Bot entry point → SMC strategy: uses (evidence: `main.py`)
- Bot entry point → Risk management: uses (evidence: `main.py`)
- Bot entry point → Economic news filter: checks (evidence: `main.py`)
- Bot entry point → Trade monitor: monitors trades (evidence: `main.py`)
- Bot entry point → Trade journal: records trades (evidence: `main.py`)
- Bot entry point → Session analytics: records sessions (evidence: `main.py`)
- Bot entry point → Correlation guard: checks exposure (evidence: `main.py`)
- SMC strategy → SMC structures: uses (evidence: `strategy/smc_strategy.py`)
- SMC strategy → Fair value gaps: uses (evidence: `strategy/smc_strategy.py`)
- SMC strategy → Signal scoring: scores signals (evidence: `strategy/smc_strategy.py`)
- SMC strategy → Session killzones: uses (evidence: `strategy/smc_strategy.py`)
- SMC strategy → Micro timing: uses (evidence: `strategy/smc_strategy.py`)
- Strategy filters → Session killzones: checks sessions (evidence: `strategy/filters.py`)
- Market context → News data fetcher: fetches news (evidence: `core/fundamental_filter.py`)
- Market context → Economic news filter: uses (evidence: `core/fundamental_filter.py`)
- Economic news filter → Myfxbook data: fetches data (evidence: `strategy/news_filter.py`)
- Risk management → Anti-tilt controls: uses controls (evidence: `strategy/risk_management.py`)
- MT5 connector → Order manager: initializes (evidence: `broker/mt5_connector.py`)
- Trade monitor → Order manager: manages positions (evidence: `strategy/trade_monitor.py`)
- Backtest engine → MT5 connector: downloads data (evidence: `backtest/backtester.py`)
- Backtest engine → SMC strategy: simulates (evidence: `backtest/backtester.py`)
- Live dashboard → Session analytics: reads stats (evidence: `utils/dashboard.py`)
- Live dashboard → Correlation guard: uses (evidence: `utils/dashboard.py`)
