Skip to content

HarshilParekh07/CodeForge

 
 

Repository files navigation

CodeForge: Options Analytics Platform 🚀

A high-performance options analytics dashboard for professional derivative traders. Built with a Next.js (TypeScript) frontend and a FastAPI (DuckDB + ML) analytics engine.

🌟 Key Features

  • Gamma Exposure (GEX): Real-time dealer hedging analysis and Gamma Flip level detection.
  • Volatility Regime: IV surface analysis (Expansion/Compression/Stable detection).
  • Liquidity Clusters: Identification of high-volume/OI concentration zones.
  • Unusual Activity: Statistical outlier detection for options flow.
  • Market Structure: Automated support/resistance levels from derivatives data.
  • Stability Score: Proprietary metric (0-100) for overall market calmness.
  • Narrative Logic: Natural language summary of current market conditions.

🛠️ Technology Stack

  • Frontend: Next.js 16 (Turbopack), React 19, ECharts, Plotly.js, Axios.
  • Backend: Python 3.x, FastAPI, DuckDB (OLAP Database), Scikit-Learn, Pandas.
  • Architecture: Separated Frontend & Backend with REST API integration.

🚀 Quick Start

1. Prerequisites

  • Node.js 18+
  • Python 3.10+
  • Git

2. Backend Setup

cd backend
pip install -r requirements.txt
python api.py

The backend will initialize the database from CSV files and start on http://localhost:8000.

3. Frontend Setup

cd frontend/options-analytics-dashboard
npm install
npm run dev

The dashboard will start on http://localhost:3000.


📂 Project Structure

CodeForge/
├── backend/                # Python FastAPI backend
│   ├── db/                 # DuckDB schema & queries
│   ├── ingestion/          # CSV data loaders & validators
│   ├── ml/                 # Quantitative models (Anomaly, Clustering)
│   ├── services/           # Analytics Service layer
│   └── api.py              # Main REST API Entry
├── frontend/dashboard/     # Next.js Application
│   ├── charts/             # ECharts/Plotly custom components
│   ├── components/         # Shared UI components
│   └── app/                # Next.js Pages & Routes
└── data/                   # Raw options CSV datasets

📝 License

Proprietary. Developed for Options Market Intelligence.

About

AI-powered options market analytics challenge for CodeForge. Participants build a visualization and analytics platform to explore derivatives data, detect patterns in volatility, open interest, and volume, and generate insights using AI and FOSS tools.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 46.8%
  • Python 37.3%
  • CSS 15.7%
  • JavaScript 0.2%