# prams2104/crypto-momentum-backtest architecture

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

- Interactive diagram: https://gitdiagram.com/prams2104/crypto-momentum-backtest
- Repository: https://github.com/prams2104/crypto-momentum-backtest

## Overview

This repository is a cryptocurrency cross-sectional momentum and reversal research study. Its principal workflow is market data and eligibility → signal construction → execution-aware backtesting → period-specific statistical and cost evaluation → visual analysis of results. The README documents these stages and major findings; notebook internals were not provided, so links between stages reflect documented methodology rather than inspected calls.

Main entry points: [`03_backtest.ipynb`](https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb) (Backtesting), [`01_data.ipynb`](https://github.com/prams2104/crypto-momentum-backtest/blob/main/01_data.ipynb) (Data Preparation), [`02_signals.ipynb`](https://github.com/prams2104/crypto-momentum-backtest/blob/main/02_signals.ipynb) (Signal Construction), [`Backtest_Visuals`](https://github.com/prams2104/crypto-momentum-backtest/tree/main/Backtest_Visuals) (Backtest Visuals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Research Inputs"]
  node_price_data["Price Data<br/>[data_px.csv]"]
  node_return_data["Return Data<br/>[data_ret.csv]"]
  node_eligibility["Eligibility Data<br/>[data_elig.csv]"]
end

subgraph group_workflow["Strategy Workflow"]
  node_data_stage["Data Preparation<br/>[01_data.ipynb]"]
  node_signal_stage["Signal Construction<br/>[02_signals.ipynb]"]
  node_strategies["Momentum and Reversal<br/>[02_signals.ipynb]"]
  node_weight_helpers["Weight Utilities<br/>[utils.py]"]
  node_backtest["Backtesting<br/>[03_backtest.ipynb]"]
end

subgraph group_evaluation["Evaluation"]
  node_cost_model["Transaction Costs<br/>[03_backtest.ipynb]"]
  node_period_tests["Period Evaluation<br/>[03_backtest.ipynb]"]
  node_alpha_tests["Alpha Statistics<br/>[03_backtest.ipynb]"]
  node_performance_helpers["Performance Metrics<br/>[utils.py]"]
end

subgraph group_findings["Analysis Outputs"]
  node_visual_results["Backtest Visuals"]
  node_signal_visuals["Signal Visuals"]
  node_regime_analysis["Regime Analysis<br/>[03_backtest.ipynb]"]
end

node_researcher(("Researcher"))

node_researcher -->|"analyzes"| node_data_stage
node_data_stage -.->|"prepares prices"| node_price_data
node_data_stage -.->|"prepares returns"| node_return_data
node_data_stage -.->|"prepares universe"| node_eligibility
node_signal_stage -->|"constructs"| node_strategies
node_signal_stage -->|"normalizes weights"| node_weight_helpers
node_backtest -->|"applies costs"| node_cost_model
node_backtest -->|"evaluates periods"| node_period_tests
node_backtest -->|"tests alpha"| node_alpha_tests
node_backtest -.->|"calculates metrics"| node_performance_helpers
node_period_tests -->|"summarizes results"| node_visual_results
node_alpha_tests -->|"visualizes alpha"| node_visual_results
node_regime_analysis -->|"shows regimes"| node_visual_results
node_signal_stage -.->|"visualizes signals"| node_signal_visuals

click node_data_stage "https://github.com/prams2104/crypto-momentum-backtest/blob/main/01_data.ipynb"
click node_price_data "https://github.com/prams2104/crypto-momentum-backtest/blob/main/data_px.csv"
click node_return_data "https://github.com/prams2104/crypto-momentum-backtest/blob/main/data_ret.csv"
click node_eligibility "https://github.com/prams2104/crypto-momentum-backtest/blob/main/data_elig.csv"
click node_signal_stage "https://github.com/prams2104/crypto-momentum-backtest/blob/main/02_signals.ipynb"
click node_strategies "https://github.com/prams2104/crypto-momentum-backtest/blob/main/02_signals.ipynb"
click node_weight_helpers "https://github.com/prams2104/crypto-momentum-backtest/blob/main/utils.py"
click node_backtest "https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb"
click node_cost_model "https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb"
click node_period_tests "https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb"
click node_alpha_tests "https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb"
click node_performance_helpers "https://github.com/prams2104/crypto-momentum-backtest/blob/main/utils.py"
click node_visual_results "https://github.com/prams2104/crypto-momentum-backtest/tree/main/Backtest_Visuals"
click node_signal_visuals "https://github.com/prams2104/crypto-momentum-backtest/tree/main/Signals_visuals"
click node_regime_analysis "https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb"

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_price_data,node_return_data,node_eligibility toneBlue
class node_data_stage,node_signal_stage,node_strategies,node_weight_helpers,node_backtest toneAmber
class node_cost_model,node_period_tests,node_alpha_tests,node_performance_helpers toneMint
class node_visual_results,node_signal_visuals,node_regime_analysis toneRose
class node_researcher toneIndigo
```

## Components

### Research Inputs

- [Price Data](https://github.com/prams2104/crypto-momentum-backtest/blob/main/data_px.csv): `data_px.csv`
- [Return Data](https://github.com/prams2104/crypto-momentum-backtest/blob/main/data_ret.csv): `data_ret.csv`
- [Eligibility Data](https://github.com/prams2104/crypto-momentum-backtest/blob/main/data_elig.csv): `data_elig.csv`

### Strategy Workflow

- [Data Preparation](https://github.com/prams2104/crypto-momentum-backtest/blob/main/01_data.ipynb): `01_data.ipynb`
- [Signal Construction](https://github.com/prams2104/crypto-momentum-backtest/blob/main/02_signals.ipynb): `02_signals.ipynb`
- [Momentum and Reversal](https://github.com/prams2104/crypto-momentum-backtest/blob/main/02_signals.ipynb): `02_signals.ipynb`
- [Weight Utilities](https://github.com/prams2104/crypto-momentum-backtest/blob/main/utils.py): `utils.py`
- [Backtesting](https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb): `03_backtest.ipynb`

### Evaluation

- [Transaction Costs](https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb): `03_backtest.ipynb`
- [Period Evaluation](https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb): `03_backtest.ipynb`
- [Alpha Statistics](https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb): `03_backtest.ipynb`
- [Performance Metrics](https://github.com/prams2104/crypto-momentum-backtest/blob/main/utils.py): `utils.py`

### Analysis Outputs

- [Backtest Visuals](https://github.com/prams2104/crypto-momentum-backtest/tree/main/Backtest_Visuals): `Backtest_Visuals`
- [Signal Visuals](https://github.com/prams2104/crypto-momentum-backtest/tree/main/Signals_visuals): `Signals_visuals`
- [Regime Analysis](https://github.com/prams2104/crypto-momentum-backtest/blob/main/03_backtest.ipynb): `03_backtest.ipynb`

### Other components

- **Researcher**

## Connections

- Researcher → Data Preparation: analyzes (evidence: `README.md`)
- Data Preparation → Price Data: prepares prices
- Data Preparation → Return Data: prepares returns
- Data Preparation → Eligibility Data: prepares universe
- Signal Construction → Momentum and Reversal: constructs (evidence: `README.md`)
- Signal Construction → Weight Utilities: normalizes weights (evidence: `README.md`)
- Backtesting → Transaction Costs: applies costs (evidence: `README.md`)
- Backtesting → Period Evaluation: evaluates periods (evidence: `README.md`)
- Backtesting → Alpha Statistics: tests alpha (evidence: `README.md`)
- Backtesting → Performance Metrics: calculates metrics
- Period Evaluation → Backtest Visuals: summarizes results (evidence: `README.md`)
- Alpha Statistics → Backtest Visuals: visualizes alpha (evidence: `README.md`)
- Regime Analysis → Backtest Visuals: shows regimes (evidence: `README.md`)
- Signal Construction → Signal Visuals: visualizes signals
