Trading tools

    An options terminal that runs on your own computer.

    Chain, OI, gamma, volatility and strategy tools for NSE and BSE options, in one free app.

    Dashboard
    01Overview

    What it is.

    Option Hub is a free options terminal for Indian F&O traders and learners.

    It brings the option chain, open interest, max pain, gamma exposure, volatility, participant positioning, a strategy builder, an optimizer, a backtester and paper trading into one app. It runs on your machine: your browser talks to a small local proxy, and the proxy fetches data from Dhan, NSE, TradingView and Yahoo Finance.

    Built with
    • React 18
    • TypeScript
    • Vite
    • Tailwind CSS
    • TanStack Query
    • IndexedDB
    • a Node.js proxy with a WebSocket relay
    LicencePolyForm Noncommercial License 1.0.0
    03Get it running

    Get it running.

    Let an AI do it for you

    Claude

    Best when you want architecture explanation, codebase understanding, and a clean implementation plan before edits.

    You need: Repo access, README context, Terminal if using Claude Code.

    How to use: Paste the prompt with the GitHub link. Ask Claude to read the README, map modules, list risks, and produce a practical plan before using Claude Code or another agent to implement.

    You are my setup assistant. Install and run "Option Hub" on my computer, then confirm it works. I am not a developer, so explain every step in simple English.
    
    Repository: https://github.com/MrChartist/india-s-best-option-hub
    What it is: Chain, OI, gamma, volatility and strategy tools for NSE and BSE options, in one free app.
    Built with: React 18 + TypeScript + Vite + Tailwind CSS + TanStack Query + IndexedDB + a Node.js proxy with a WebSocket relay
    
    Rules
    1. Ask which operating system I use (Windows, macOS or Linux) and give commands for that system only.
    2. Check what is already installed (Git, Node.js or Python versions) before installing anything. If something is missing, tell me where to download it and wait.
    3. Ask me before installing anything globally or changing system settings.
    4. Never ask me to paste passwords or API keys into this chat. If a key is needed, tell me which file to put it in.
    5. Do not edit the project's source code unless I ask.
    6. Read the README first. If it disagrees with the steps below, follow the README and tell me why.
    
    Steps from the guide
    1. Install Node.js 20 or higher (the LTS version from nodejs.org).
    2. Clone: git clone https://github.com/MrChartist/india-s-best-option-hub.git && cd india-s-best-option-hub. No Git? Use Code, then Download ZIP on GitHub and extract it.
    3. Install: npm install
    4. Start: npm run dev. This runs the app on port 4001 and the local data proxy on port 4002 together.
    5. Open http://localhost:4001. Without broker keys you get NSE and public data where available, and labelled sample data where not.
    6. Optional: for the best chain, Greeks and live ticks, add a free Dhan API key in Broker Settings, or copy .env.example to .env and set DHAN_CLIENT_ID and DHAN_ACCESS_TOKEN.
    7. Shows Sample data everywhere? Make sure you ran npm run dev (not npm run dev:vite) and open http://localhost:4002/health. Outside market hours, NSE and brokers often return empty data.
    8. Docker: docker compose up --build, then open http://localhost:4001. Ports bind to 127.0.0.1 only, because the proxy can hold your broker token.
    9. Before changing code, run npm run check (typecheck, lint, tests and build).
    
    When the steps are done
    - Start the app and tell me the exact address to open. Expected address: http://localhost:4001
    - If an error appears, read it, fix the cause and retry. After three failed attempts, stop and explain the problem simply.
    - Finish with five short lines: what the app does, how to start it again, how to stop it, where its data is stored, and one thing I can try first.
    - This is an information tool. It is not investment advice.
    
    If you can run a terminal (Claude Code), do it yourself. If you are chat only, give me one command block at a time and wait for me to reply before the next.

    Or run it yourself

    You need Node.js 20 or higher; git, or the ZIP from GitHub; chrome, Edge, Brave or Safari; optional: a free Dhan API key.

    Open a terminal and run
    git clone https://github.com/MrChartist/india-s-best-option-hub.gitcd india-s-best-option-hubnpm installnpm run dev
    Then open http://localhost:4001 in your browser.
    04FAQ

    Questions about Option Hub.

    Best next step

    Run it, then read the code.

    Run npm run dev, open the Option Chain and Gamma Exposure pages, then ask an AI to explain src/lib/options before you change any number the app shows.

    Privacy settings

    Essential sign-in storage and your saved preferences stay enabled. Analytics is optional, and you can change your choice anytime.

    Turning analytics off clears our analytics cookies and local assistant metrics. The page reloads to stop a previously loaded analytics service. Your account and learning progress stay saved.

    Read the Privacy Policy