Skip to content

cuzohh/gexlab

Repository files navigation

GEXLAB

GEXLAB Gamma Exposure Web dashboard + native desktop app for local, more reliable use Local App Preferred Website Can Rate-Limit

React FastAPI Electron ECharts

Free gamma exposure analytics for retail traders, with a native desktop app for local use.

Why Local AppFeaturesDesktop AppWeb DevRoadmap

gamma exposure options analytics desktop app fastapi react


Why This Exists

GEXLAB makes dealer positioning visible without requiring a paid terminal.

It includes:

  • GEX profile by strike
  • GEX heatmap by expiration
  • Key Levels such as Call Wall, Put Wall, Zero Gamma, Max Pain, and Vol Trigger
  • DEX, Vanna, IV Skew, Put/Call Ratio, OI Distribution, unusual flow, and topology views
  • Futures Translation for mappings like SPY -> /ES and QQQ -> /NQ
  • A native desktop app that bundles the frontend and backend into an installable local application

Recommended Usage

Important

The website can get rate-limited often during heavier usage because requests stack through shared web infrastructure and the upstream data source. If you want the stable version, use the local desktop app.

Why the local app is better:

  • fewer rate-limit collisions from shared web traffic
  • the backend runs on your machine instead of through a shared hosted layer
  • no browser-tab localhost workflow for end users
  • generally better reliability during market hours
Short version

Use the website for quick access. Use the desktop app for actual regular use.

Feature Grid

Gamma Structure

Map dealer gamma exposure by strike, identify walls, and track regime shifts around zero gamma.

Term Structure

Use the heatmap and expiration views to see where near-dated positioning is concentrated.

Local Desktop App

Install a native app window that starts the bundled backend locally for a more reliable experience.

Key Levels

Call Wall, Put Wall, Zero Gamma, Vol Trigger, and Max Pain are computed directly from the options chain.

Dealer Flow Signals

Inspect DEX, vanna, IV skew, put/call ratio, unusual flow, and OI concentration in one place.

Futures Translation

Translate ETF levels to futures equivalents so the levels are usable on actual futures charts.

At A Glance

Area What it does Why it matters
GEX Profile Shows net dealer gamma by strike Helps identify pinning, resistance, and support zones
Heatmap Breaks exposure across expirations Makes near-dated pressure easier to spot
Key Levels Computes Call Wall, Put Wall, Zero Gamma, Vol Trigger, and Max Pain Provides a practical trading map
Desktop App Runs the backend locally in a native window Reduces web bottlenecks and rate-limit issues
Futures Translation Maps ETF levels to futures equivalents Makes levels usable on /ES, /NQ, and related charts

Web Vs Local App

Website:
browser -> hosted frontend -> hosted backend -> market data source

Desktop app:
native app window -> local bundled backend -> market data source

The desktop route removes the shared hosted bottleneck, which is the part most likely to get hit when traffic spikes.

Tip

If you are sharing this project with users, point them to the downloadable desktop installer first and treat the website as the lighter fallback path.

Stack

  • Frontend: React, TypeScript, Vite, ECharts
  • Backend: FastAPI, Python
  • Desktop: Electron, PyInstaller, electron-builder
  • Data: Yahoo Finance-backed options data processed by the backend

Desktop App

Windows installer output:

  • desktop-dist/GEXLAB-Setup-1.0.0.exe

Cross-platform packaging is configured in package.json for:

  • Windows: nsis
  • macOS: dmg, zip
  • Linux: AppImage, deb
Run the desktop app from source
npm run desktop:build:frontend
run_desktop_app.bat
Build the Windows installer
npm install
backend\venv\Scripts\python.exe -m pip install -r backend\requirements.txt
backend\venv\Scripts\python.exe -m pip install pyinstaller
npm run desktop:build

Web Development

Start the web development stack

Backend:

run_backend.bat

Frontend:

run_frontend.bat

Then open:

http://localhost:3000

Formula

GEX = Gamma x Open Interest x 100 x Spot^2 x 0.01 / 1,000,000,000

Interpretation:

  • Output is in billions of dollars per 1% move
  • Positive net gamma tends to dampen volatility
  • Negative net gamma tends to amplify volatility
What the sign usually implies
  • Positive Gamma: Dealers tend to buy dips and sell rips, which can suppress volatility.
  • Negative Gamma: Dealers tend to chase price direction, which can amplify volatility.

Project Layout

backend/                FastAPI app and GEX engine
frontend/               React dashboard
desktop/                Electron shell and desktop assets
desktop-build/          Intermediate desktop build artifacts
desktop-dist/           Installers and packaged app output
run_backend.bat         Local backend runner
run_frontend.bat        Local frontend runner
run_desktop_app.bat     Local desktop app runner

Notes

  • The desktop app is the preferred distribution because it is less likely to encounter rate-limiting issues compared to the shared web version.
  • The desktop app uses a loopback connection internally for its bundled backend, providing a native app experience without a browser dependency.
  • Build artifacts are automatically ignored via .gitignore.

Roadmap

  • Shrink the frontend bundle with route-level or chart-level code splitting
  • Use CI builds for Windows, macOS, and Linux installers
  • Provide signed Windows releases and cleaner release artifacts
  • Improve caching and request strategy to reduce upstream rate-limit pressure
  • Add more market structure views and better historical comparison workflows

Contributing

If you are modifying the project:

  • Ensure the desktop path remains functional, not just the browser development path.
  • Prioritize changes that improve local reliability during market hours.
  • Avoid adding hosted-only assumptions, as the desktop app is the primary distribution.

Disclaimer

This project is for informational and educational use. It is not financial advice. Options trading is high risk.

About

All-In-One suite for Options Flow Analysis

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors