# minggnim/crypto-strategy architecture

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

- Interactive diagram: https://gitdiagram.com/minggnim/crypto-strategy
- Repository: https://github.com/minggnim/crypto-strategy

## Overview

crypto-strategy is a Python toolkit for optimizing, inspecting, and backtesting cryptocurrency trading strategies. The principal workflow starts with a CLI or Python caller, loads market history, evaluates MA, breakout, or MACD strategies and filters across parameters, then saves results for inspection and reporting. Its underlying finlab_crypto package supplies data collection, strategy/filter abstractions, indicators, charting, overfitting analysis, and optional live-trading and portfolio utilities. Edges reflect the README and source references shown; several subsystems are represented from documentation or the source index rather than inspected implementation excerpts.

Main entry points: [`src/crypto_strategy/strategies/base.py`](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/base.py) (Strategy Engine), [`src/crypto_strategy/strategies/bo_strategy.py`](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/bo_strategy.py) (Breakout Strategy), [`src/crypto_strategy/strategies/ma_strategy.py`](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/ma_strategy.py) (MA Strategy), [`src/crypto_strategy/data.py`](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/data.py) (Market Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_strategy["Backtest Strategies"]
  node_cli["Command Line<br/>[cli.py]"]
  node_data["Market Data<br/>[data.py]"]
  node_base["Strategy Engine<br/>[base.py]"]
  node_ma["MA Strategy<br/>[ma_strategy.py]"]
  node_bo["Breakout Strategy<br/>[bo_strategy.py]"]
  node_macd["MACD Strategy<br/>[macd_strategy.py]"]
end

subgraph group_analysis["Results and Analysis"]
  node_reportbase["Report Analysis<br/>[base.py]"]
  node_report["Report Generation<br/>[report.py]"]
  node_plot["Performance Plots<br/>[plot.py]"]
end

subgraph group_library["Crypto Toolkit"]
  node_crawler["Exchange Crawler<br/>[crawler.py]"]
  node_indicators["Technical Indicators<br/>[indicators.py]"]
  node_strategyapi["Strategy API<br/>[strategy.py]"]
  node_utility["Backtest Utilities<br/>[utility.py]"]
  node_chart["Charting<br/>[chart.py]"]
  node_overfit["Overfitting Analysis<br/>[overfitting.py]"]
end

subgraph group_trading["Portfolio and Trading"]
  node_weighting["Portfolio Weighting"]
  node_portutils["Portfolio Utilities<br/>[portfolio_utils.py]"]
  node_online["Online Trading<br/>[online.py]"]
end

node_user(("Engineer / User"))

node_user -->|"invokes"| node_cli
node_cli -->|"dispatches"| node_ma
node_cli -->|"dispatches"| node_bo
node_cli -->|"dispatches"| node_report
node_user -->|"configures"| node_ma
node_user -->|"configures"| node_bo
node_user -->|"configures"| node_macd
node_ma -->|"inherits"| node_base
node_bo -->|"inherits"| node_base
node_macd -->|"inherits"| node_base
node_base -->|"loads history"| node_data
node_data -->|"downloads candles"| node_crawler
node_base -->|"uses abstractions"| node_strategyapi
node_base -->|"uses indicators"| node_indicators
node_base -->|"plots results"| node_plot
node_bo -->|"loads history"| node_data
node_ma -->|"loads history"| node_data
node_macd -->|"loads history"| node_data
node_reportbase -->|"runs CSCV"| node_overfit
node_plot -->|"requests analysis"| node_reportbase
node_report -->|"plots returns"| node_plot
node_report -->|"uses return timeline"| node_bo
node_utility -->|"renders charts"| node_chart
node_strategyapi -->|"runs CSCV"| node_overfit
node_portutils -->|"uses trading data"| node_online
node_online -->|"loads candles"| node_crawler
node_weighting -->|"uses strategy results"| node_ma
node_weighting -->|"uses strategy results"| node_bo

click node_cli "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/commands/cli.py"
click node_data "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/data.py"
click node_base "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/base.py"
click node_ma "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/ma_strategy.py"
click node_bo "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/bo_strategy.py"
click node_macd "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/macd_strategy.py"
click node_reportbase "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/reporting/base.py"
click node_report "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/reporting/report.py"
click node_plot "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/reporting/plot.py"
click node_weighting "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/portfolio/portfolio_weighting.py"
click node_portutils "https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/portfolio/portfolio_utils.py"
click node_crawler "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/crawler.py"
click node_indicators "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/indicators.py"
click node_strategyapi "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/strategy.py"
click node_utility "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/utility.py"
click node_chart "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/chart.py"
click node_overfit "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/overfitting.py"
click node_online "https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/online.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_cli,node_data,node_base,node_ma,node_bo,node_macd,node_user toneBlue
class node_reportbase,node_report,node_plot toneAmber
class node_crawler,node_indicators,node_strategyapi,node_utility,node_chart,node_overfit toneMint
class node_weighting,node_portutils,node_online toneRose
```

## Components

### Backtest Strategies

- [Command Line](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/commands/cli.py): `src/crypto_strategy/commands/cli.py`
- [Market Data](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/data.py): `src/crypto_strategy/data.py`
- [Strategy Engine](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/base.py): `src/crypto_strategy/strategies/base.py`
- [MA Strategy](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/ma_strategy.py): `src/crypto_strategy/strategies/ma_strategy.py`
- [Breakout Strategy](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/bo_strategy.py): `src/crypto_strategy/strategies/bo_strategy.py`
- [MACD Strategy](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/strategies/macd_strategy.py): `src/crypto_strategy/strategies/macd_strategy.py`

### Results and Analysis

- [Report Analysis](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/reporting/base.py): `src/crypto_strategy/reporting/base.py`
- [Report Generation](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/reporting/report.py): `src/crypto_strategy/reporting/report.py`
- [Performance Plots](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/reporting/plot.py): `src/crypto_strategy/reporting/plot.py`

### Crypto Toolkit

- [Exchange Crawler](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/crawler.py): `src/finlab_crypto/crawler.py`
- [Technical Indicators](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/indicators.py): `src/finlab_crypto/indicators.py`
- [Strategy API](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/strategy.py): `src/finlab_crypto/strategy.py`
- [Backtest Utilities](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/utility.py): `src/finlab_crypto/utility.py`
- [Charting](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/chart.py): `src/finlab_crypto/chart.py`
- [Overfitting Analysis](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/overfitting.py): `src/finlab_crypto/overfitting.py`

### Portfolio and Trading

- [Portfolio Weighting](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/portfolio/portfolio_weighting.py): `src/crypto_strategy/portfolio/portfolio_weighting.py`
- [Portfolio Utilities](https://github.com/minggnim/crypto-strategy/blob/master/src/crypto_strategy/portfolio/portfolio_utils.py): `src/crypto_strategy/portfolio/portfolio_utils.py`
- [Online Trading](https://github.com/minggnim/crypto-strategy/blob/master/src/finlab_crypto/online.py): `src/finlab_crypto/online.py`

### Other components

- **Engineer / User**

## Connections

- Engineer / User → Command Line: invokes (evidence: `README.md`)
- Command Line → MA Strategy: dispatches (evidence: `src/crypto_strategy/commands/cli.py`)
- Command Line → Breakout Strategy: dispatches (evidence: `src/crypto_strategy/commands/cli.py`)
- Command Line → Report Generation: dispatches (evidence: `src/crypto_strategy/commands/cli.py`)
- Engineer / User → MA Strategy: configures (evidence: `README.md`)
- Engineer / User → Breakout Strategy: configures (evidence: `README.md`)
- Engineer / User → MACD Strategy: configures (evidence: `README.md`)
- MA Strategy → Strategy Engine: inherits (evidence: `src/crypto_strategy/strategies/ma_strategy.py`)
- Breakout Strategy → Strategy Engine: inherits (evidence: `src/crypto_strategy/strategies/bo_strategy.py`)
- MACD Strategy → Strategy Engine: inherits (evidence: `src/crypto_strategy/strategies/macd_strategy.py`)
- Strategy Engine → Market Data: loads history (evidence: `src/crypto_strategy/strategies/base.py`)
- Market Data → Exchange Crawler: downloads candles (evidence: `src/crypto_strategy/data.py`)
- Strategy Engine → Strategy API: uses abstractions (evidence: `src/crypto_strategy/strategies/base.py`)
- Strategy Engine → Technical Indicators: uses indicators (evidence: `src/crypto_strategy/strategies/base.py`)
- Strategy Engine → Performance Plots: plots results (evidence: `src/crypto_strategy/strategies/base.py`)
- Breakout Strategy → Market Data: loads history (evidence: `src/crypto_strategy/strategies/bo_strategy.py`)
- MA Strategy → Market Data: loads history (evidence: `src/crypto_strategy/strategies/ma_strategy.py`)
- MACD Strategy → Market Data: loads history (evidence: `src/crypto_strategy/strategies/macd_strategy.py`)
- Report Analysis → Overfitting Analysis: runs CSCV (evidence: `src/crypto_strategy/reporting/base.py`)
- Performance Plots → Report Analysis: requests analysis (evidence: `src/crypto_strategy/reporting/plot.py`)
- Report Generation → Performance Plots: plots returns (evidence: `src/crypto_strategy/reporting/report.py`)
- Report Generation → Breakout Strategy: uses return timeline (evidence: `src/crypto_strategy/reporting/report.py`)
- Backtest Utilities → Charting: renders charts (evidence: `src/finlab_crypto/utility.py`)
- Strategy API → Overfitting Analysis: runs CSCV (evidence: `src/finlab_crypto/strategy.py`)
- Portfolio Utilities → Online Trading: uses trading data (evidence: `src/crypto_strategy/portfolio/portfolio_utils.py`)
- Online Trading → Exchange Crawler: loads candles (evidence: `src/finlab_crypto/online.py`)
- Portfolio Weighting → MA Strategy: uses strategy results (evidence: `src/crypto_strategy/portfolio/portfolio_weighting.py`)
- Portfolio Weighting → Breakout Strategy: uses strategy results (evidence: `src/crypto_strategy/portfolio/portfolio_weighting.py`)
