Skip to content

Repository files navigation

Quant Option Research Platform

System Architecture

A modular quantitative options research platform integrating volatility modeling, options strategy research, portfolio analytics, risk management, and automated research documentation.


Overview

The Quant Option Research Platform is a research-oriented quantitative framework designed to build a complete and reproducible workflow for systematic options research.

The platform connects the full quantitative research lifecycle:

Research Workflow

The objective of this project is to bridge the gap between quantitative research prototypes and a structured research infrastructure.

The framework focuses on:

  • Volatility research
  • Options strategy development
  • Portfolio analytics
  • Risk monitoring
  • Automated technical documentation

Key Features

1. Volatility Research Engine

The volatility research module focuses on analyzing option market structures.

Main capabilities:

  • Implied volatility calculation
  • Volatility smile analysis
  • Volatility surface construction
  • Term structure analysis
  • ATM volatility monitoring
  • Moneyness-based volatility analysis

Research outputs include:

  • IV surface visualization
  • Smile evolution analysis
  • Term structure monitoring
  • Volatility signal generation

2. Strategy Research Framework

The strategy layer adopts a modular registry-based architecture.

Each strategy is represented through a structured research record containing:

  • Strategy motivation
  • Construction rules
  • Entry and exit logic
  • Greeks profile
  • Backtest evidence
  • Performance summary
  • Limitations
  • Future extensions

Current research strategies include:

  • Volatility strategies
  • Strangle structures
  • Calendar spreads
  • Butterfly structures

The framework allows future strategies to be added without redesigning the research infrastructure.


3. Portfolio Management Engine

The portfolio layer provides systematic portfolio analytics:

  • Position tracking
  • NAV calculation
  • Exposure aggregation
  • Portfolio Greeks calculation
  • Risk snapshot generation

Core components:

  • PositionBook
  • Portfolio Engine
  • NAV Engine

4. Risk Management Framework

The risk module evaluates portfolio exposure through option Greeks.

Covered risk measures include:

  • Delta exposure
  • Gamma exposure
  • Vega exposure
  • Portfolio risk status

The system generates:

  • Exposure reports
  • Risk dashboards
  • Portfolio monitoring summaries

Automated Research Documentation

A key feature of this project is automated technical documentation generation.

The reporting framework transforms research outputs into structured documents.

Workflow:

Research Data
      |
      v
Analysis Pipeline
      |
      v
Visualization Generation
      |
      v
Automated Report Builder
      |
      v
Technical Documentation

Generated documents include:

  • English technical white paper
  • Chinese technical white paper
  • Strategy documentation
  • Research summaries

System Architecture

The project follows a modular architecture:

Quant Option Research Platform

|
├── Data Layer
|      Market data loading and preprocessing
|
├── Analysis Layer
|      Research analysis modules
|
├── Volatility Engine
|      IV / Smile / Surface / Term Structure
|
├── Strategy Framework
|      Strategy registry and backtesting
|
├── Portfolio Engine
|      Position and NAV management
|
├── Risk Engine
|      Greeks and exposure monitoring
|
├── Monitoring Layer
|      Risk status and reporting
|
└── Reporting Framework
       Automated documentation generation

Selected Research Outputs

Volatility Surface

Volatility Surface

Portfolio Performance

Portfolio NAV

Risk Monitoring

Risk Dashboard

Empirical Results on the Available Sample

The published research uses intraday Chinese index option and futures data from 2026-01-02 to 2026-06-10. The Phase I prototype completed 4 trades, with 3 winners, a reported cumulative return of 30.5%, and a maximum drawdown of -0.92%.

The expanded strategy evaluation reports:

Strategy Win Rate Average Return Best Return Worst Return
Long ATM Strangle 28.57% -2.1074% 6.8016% -9.4435%
Long Call Butterfly 100.00% 8.0018% 17.7778% 0.0000%
Calendar Spread 13.33% -29.5095% 61.6839% -87.6428%

These are preliminary results from a short 2026 sample, not evidence of stable out-of-sample profitability. Raw licensed market data and generated research tables are excluded from the public repository, so third parties cannot fully reproduce the reported values from the repository alone. See the Phase I report and technical white paper.


Project Structure

Quant-Option-Research-Platform

|
├── analysis/
|      Research analysis modules
|
├── config/
|      Configuration and research settings
|
├── framework/
|      Core quantitative research framework
|
├── scripts/
|      Research pipelines and automation scripts
|
├── docs/
|      Research design documents and figures
|
└── research/
       Reports and documentation

Research Documentation

Complete technical documentation is available in:

English White Paper

research/reports/quant_option_technical_white_paper_v3_0.docx

Chinese White Paper

research/reports/quant_option_technical_white_paper_cn_v1_0.docx

The documents cover:

  • Research methodology
  • Volatility analysis
  • Strategy framework
  • Portfolio management
  • Risk monitoring
  • System architecture

Installation

Clone the repository:

git clone https://github.com/mdldpc/Quant-Option-Research-Platform.git

cd Quant-Option-Research-Platform

Create a virtual environment:

python -m venv venv

Activate environment:

Windows

venv\Scripts\activate

Linux / macOS

source venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Usage

Run Research Scripts

python scripts/<script_name>.py

Generate Documentation

English:

python -m scripts.rebuild.build_documentation_v3_1

Chinese:

python -m scripts.rebuild.build_documentation_cn_v1_0

The pipeline automatically generates:

  • Research figures
  • Tables
  • Technical documentation

Research Workflow

1. Prepare Market Data

        |
        v

2. Build Research Dataset

        |
        v

3. Analyze Volatility Structure

        |
        v

4. Generate Strategy Signals

        |
        v

5. Run Backtests

        |
        v

6. Evaluate Portfolio Risk

        |
        v

7. Generate Research Report

Small-Sample Machine Learning

The project includes a regime-aware meta-labeling workflow designed for short option histories. It uses purged and embargoed expanding walk-forward tests, PCA/GMM regimes, regularized and nonlinear baselines, portfolio-level metrics, block-bootstrap uncertainty, calibration, and reproducibility manifests.

See docs/small_sample_ml.md.


Future Roadmap

Potential extensions:

  • Additional volatility strategies
  • More comprehensive historical datasets
  • Advanced portfolio optimization
  • Machine learning based volatility forecasting
  • Real-time market data integration
  • Cloud-based research deployment

License

This project is developed for quantitative research and educational purposes.

About

A quantitative research platform for option volatility modeling, Greeks calculation, strategy backtesting, and robustness analysis.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages