Skip to content

DavidYu75/black-scholes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

28 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Black-Scholes Interactive Dashboard

A modern, interactive Black-Scholes options pricing calculator with real-time parameter controls and dynamic heatmap visualizations. Built for financial professionals, educators, and traders seeking intuitive options analysis tools.

✨ Features

  • Real-time Options Pricing - Instant Call/Put price calculations using the Black-Scholes formula
  • Interactive Parameter Controls - Real-time sliders for spot price, strike, volatility, time to expiration, and risk-free rate
  • Dynamic Heatmaps - Interactive visualizations showing option price sensitivity across spot price and volatility ranges
  • Greeks Calculations - Delta, Gamma, and other sensitivity metrics
  • Professional UI - Clean, dark-themed interface optimized for financial analysis
  • Educational Focus - Clear parameter explanations and intuitive design for learning options concepts

πŸ› οΈ Tech Stack

Backend

  • FastAPI (Python) - High-performance API framework
  • NumPy & SciPy - Mathematical computations
  • Pydantic - Data validation and serialization

Frontend

  • Next.js 14 - React framework with App Router
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first styling
  • Plotly.js - Interactive data visualizations

Deployment

  • Vercel (Frontend) - Optimized for Next.js
  • Railway/Render (Backend) - FastAPI hosting

πŸš€ Quick Start

Prerequisites

  • Python 3.11+
  • Node.js 18+
  • npm/yarn

Backend Setup

# Clone repository and navigate to backend
cd backend

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Start FastAPI server
uvicorn main:app --reload --host 0.0.0.0 --port 8000

Frontend Setup

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

Access Application

πŸ“Š How It Works

  1. Input Parameters - Adjust option parameters using the sidebar controls
  2. Real-time Calculation - Backend processes Black-Scholes formula instantly
  3. Visual Analysis - View results through price displays and interactive heatmaps
  4. Sensitivity Analysis - Explore how parameter changes affect option prices

🎯 Use Cases

  • Educational - Learn Black-Scholes concepts through interactive visualization
  • Professional Analysis - Analyze option pricing scenarios and sensitivities
  • Strategy Development - Explore different market conditions and their impact
  • Risk Assessment - Understand how Greeks affect option positions

πŸ“ˆ Project Structure

blackscholes-dashboard/
β”œβ”€β”€ backend/                 # FastAPI application
β”‚   β”œβ”€β”€ models/             # Black-Scholes calculation engine
β”‚   β”œβ”€β”€ routers/            # API endpoints
β”‚   β”œβ”€β”€ schemas/            # Request/response models
β”‚   └── main.py             # Application entry point
└── frontend/               # Next.js application
    β”œβ”€β”€ app/                # App Router pages
    β”œβ”€β”€ components/         # React components
    β”œβ”€β”€ lib/                # API client and utilities
    └── types/              # TypeScript definitions

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published