# coderixc/banknifty_algo_strategy architecture

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

- Interactive diagram: https://gitdiagram.com/coderixc/banknifty_algo_strategy
- Repository: https://github.com/coderixc/banknifty_algo_strategy

## Overview

This repository contains two standalone analysis workflows: an intraday futures-strategy backtest and an NSE bhav-copy Marubozu scanner. The backtest loads and time-filters market data, separates futures and options, computes moving averages, simulates trade entries and exits, and reports performance while building a candlestick chart. The scanner loads an equity bhav copy, filters eligible symbols, detects bullish and bearish Marubozu candles, and prints the results. Edges reflect the shown scripts; README-described capabilities are included where supported, but unsampled data files and unshown behavior are not inferred.

Main entry points: [`main.py`](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py) (Trade Simulation), [`MaruBuzoCandlesticks.py`](https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py) (Scanner Setup), [`Data/512023+2023-01-05.csv`](https://github.com/coderixc/banknifty_algo_strategy/blob/master/Data/512023%2B2023-01-05.csv) (Intraday CSV), [`Data/cm30AUG2023bhav.csv`](https://github.com/coderixc/banknifty_algo_strategy/blob/master/Data/cm30AUG2023bhav.csv) (Bhav Copy CSV)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backtest["Strategy Backtest"]
  node_intraday_data["Intraday CSV"]
  node_load_filter["Load and Filter<br/>[main.py]"]
  node_future_slice["Futures Slice<br/>[main.py]"]
  node_option_slice["Options Slice<br/>[main.py]"]
  node_moving_averages["Moving Averages<br/>[main.py]"]
  node_trade_simulation["Trade Simulation<br/>[main.py]"]
  node_exit_management["Exit Management<br/>[main.py]"]
  node_trade_ledger["Trade Ledger<br/>[main.py]"]
end

subgraph group_candles["Candle Scanner"]
  node_bhav_copy["Bhav Copy CSV"]
  node_scanner_setup["Scanner Setup"]
  node_quote_filter["Quote Filtering"]
  node_pattern_detection["Pattern Detection"]
  node_pattern_report["Pattern Report"]
end

subgraph group_outputs["Analysis Outputs"]
  node_performance_stats["Performance Metrics<br/>[main.py]"]
  node_candlestick_chart["Candlestick Chart<br/>[main.py]"]
end

node_analyst(("Analyst"))

node_analyst -->|"runs backtest"| node_load_filter
node_intraday_data -->|"supplies rows"| node_load_filter
node_load_filter -->|"filters futures"| node_future_slice
node_load_filter -->|"filters options"| node_option_slice
node_future_slice -->|"calculates averages"| node_moving_averages
node_moving_averages -->|"signals trades"| node_trade_simulation
node_trade_simulation -->|"checks open trades"| node_exit_management
node_trade_simulation -->|"records entries"| node_trade_ledger
node_exit_management -->|"updates trades"| node_trade_ledger
node_trade_ledger -->|"summarizes PnL"| node_performance_stats
node_future_slice -->|"plots OHLC"| node_candlestick_chart
node_trade_simulation -->|"marks entries"| node_candlestick_chart
node_exit_management -->|"marks exits"| node_candlestick_chart
node_analyst -->|"runs scanner"| node_scanner_setup
node_bhav_copy -->|"loads quotes"| node_scanner_setup
node_scanner_setup -->|"sets thresholds"| node_quote_filter
node_quote_filter -->|"checks candles"| node_pattern_detection
node_pattern_detection -->|"prints matches"| node_pattern_report

click node_intraday_data "https://github.com/coderixc/banknifty_algo_strategy/blob/master/Data/512023%2B2023-01-05.csv"
click node_load_filter "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_future_slice "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_option_slice "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_moving_averages "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_trade_simulation "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_exit_management "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_trade_ledger "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_performance_stats "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_candlestick_chart "https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py"
click node_bhav_copy "https://github.com/coderixc/banknifty_algo_strategy/blob/master/Data/cm30AUG2023bhav.csv"
click node_scanner_setup "https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py"
click node_quote_filter "https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py"
click node_pattern_detection "https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py"
click node_pattern_report "https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.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_intraday_data,node_load_filter,node_future_slice,node_option_slice,node_moving_averages,node_trade_simulation,node_exit_management,node_trade_ledger toneBlue
class node_bhav_copy,node_scanner_setup,node_quote_filter,node_pattern_detection,node_pattern_report toneAmber
class node_performance_stats,node_candlestick_chart toneMint
class node_analyst toneIndigo
```

## Components

### Strategy Backtest

- [Intraday CSV](https://github.com/coderixc/banknifty_algo_strategy/blob/master/Data/512023%2B2023-01-05.csv): `Data/512023+2023-01-05.csv`
- [Load and Filter](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Futures Slice](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Options Slice](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Moving Averages](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Trade Simulation](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Exit Management](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Trade Ledger](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`

### Candle Scanner

- [Bhav Copy CSV](https://github.com/coderixc/banknifty_algo_strategy/blob/master/Data/cm30AUG2023bhav.csv): `Data/cm30AUG2023bhav.csv`
- [Scanner Setup](https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py): `MaruBuzoCandlesticks.py`
- [Quote Filtering](https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py): `MaruBuzoCandlesticks.py`
- [Pattern Detection](https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py): `MaruBuzoCandlesticks.py`
- [Pattern Report](https://github.com/coderixc/banknifty_algo_strategy/blob/master/MaruBuzoCandlesticks.py): `MaruBuzoCandlesticks.py`

### Analysis Outputs

- [Performance Metrics](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`
- [Candlestick Chart](https://github.com/coderixc/banknifty_algo_strategy/blob/master/main.py): `main.py`

### Other components

- **Analyst**

## Connections

- Analyst → Load and Filter: runs backtest (evidence: `README.md`)
- Intraday CSV → Load and Filter: supplies rows (evidence: `main.py`)
- Load and Filter → Futures Slice: filters futures (evidence: `main.py`)
- Load and Filter → Options Slice: filters options (evidence: `main.py`)
- Futures Slice → Moving Averages: calculates averages (evidence: `main.py`)
- Moving Averages → Trade Simulation: signals trades (evidence: `main.py`)
- Trade Simulation → Exit Management: checks open trades (evidence: `main.py`)
- Trade Simulation → Trade Ledger: records entries (evidence: `main.py`)
- Exit Management → Trade Ledger: updates trades (evidence: `main.py`)
- Trade Ledger → Performance Metrics: summarizes PnL (evidence: `main.py`)
- Futures Slice → Candlestick Chart: plots OHLC (evidence: `main.py`)
- Trade Simulation → Candlestick Chart: marks entries (evidence: `main.py`)
- Exit Management → Candlestick Chart: marks exits (evidence: `main.py`)
- Analyst → Scanner Setup: runs scanner (evidence: `MaruBuzoCandlesticks.py`)
- Bhav Copy CSV → Scanner Setup: loads quotes (evidence: `MaruBuzoCandlesticks.py`)
- Scanner Setup → Quote Filtering: sets thresholds (evidence: `MaruBuzoCandlesticks.py`)
- Quote Filtering → Pattern Detection: checks candles (evidence: `MaruBuzoCandlesticks.py`)
- Pattern Detection → Pattern Report: prints matches (evidence: `MaruBuzoCandlesticks.py`)
