Metadata-Version: 2.4
Name: quantflow-finance
Version: 0.1.2
Summary: Professional quantitative finance library for options pricing, risk analytics, and portfolio management
Home-page: https://github.com/jeevanba273/quantflow-finance
Author: Jeevan B A
Author-email: jeevanba273@gmail.com
Project-URL: Bug Reports, https://github.com/jeevanba273/quantflow-finance/issues
Project-URL: Source, https://github.com/jeevanba273/quantflow-finance
Project-URL: Documentation, https://github.com/jeevanba273/quantflow-finance#readme
Keywords: quantitative finance,options pricing,risk management,black-scholes,portfolio analysis,financial engineering,derivatives,VaR,market data
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.20.0
Requires-Dist: scipy>=1.7.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: matplotlib>=3.3.0
Requires-Dist: yfinance>=0.1.70
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# QuantFlow Finance

**Professional-grade quantitative finance tools for Python**

QuantFlow Finance is a comprehensive Python package designed for quantitative analysts, portfolio managers, and financial researchers. It provides industry-standard implementations of essential financial models and risk management tools.

## 🎯 Core Features

### Options Pricing & Greeks
- **Black-Scholes Model**: Complete European options pricing implementation
- **Full Greeks Suite**: Delta, Gamma, Theta, Vega, and Rho calculations
- **Implied Volatility**: Newton-Raphson solver for market volatility extraction
- **Mathematical Precision**: Validated against academic benchmarks

### Risk Analytics
- **Value at Risk (VaR)**: Historical and parametric implementations
- **Expected Shortfall**: Advanced tail risk measurement (Conditional VaR)
- **Performance Metrics**: Sharpe ratio, maximum drawdown, risk-adjusted returns
- **Portfolio Analysis**: Comprehensive risk assessment tools

### Market Data Integration
- **Real-time Data**: Yahoo Finance integration for live market feeds
- **Multi-asset Support**: Stocks, indices, and portfolio analysis
- **Data Processing**: Automated return calculations and preprocessing
- **Flexible Timeframes**: Support for various data intervals and periods

## 🚀 Quick Start

```python
from quantflow import BlackScholes, RiskMetrics, MarketData

# Price options with full Greeks
option = BlackScholes(S=100, K=105, T=0.25, r=0.05, sigma=0.2)
print(f"Price: ${option.price():.2f}, Delta: {option.delta():.3f}")

# Analyze portfolio risk
data = MarketData.fetch_stock_data(['AAPL', 'MSFT'], period='1y')
returns = MarketData.calculate_returns(data)
risk = RiskMetrics(returns['AAPL'])
print(f"VaR (95%): {risk.var_historical(0.05):.2%}")
```

## 📊 Professional Applications

Perfect for:
- **Academic Research**: MFE, MSF, and PhD programs
- **Quantitative Analysis**: Portfolio management and risk assessment
- **Financial Engineering**: Derivatives pricing and modeling
- **Certification Prep**: CQF, FRM, and advanced CFA studies

## 🎓 Educational Use

Designed with academic rigor and educational applications in mind:
- Comprehensive documentation with mathematical foundations
- Real-world examples using live market data
- Professional-grade implementations suitable for research
- Perfect for graduate-level quantitative finance coursework

## 📈 Mathematical Validation

All implementations are mathematically validated:
- Put-call parity verification (error < 0.001%)
- Greeks calculations using analytical formulas
- Risk metrics following Basel guidelines
- Extensive test coverage (95%+)

## 🔗 Links

- **Documentation**: [GitHub Repository](https://github.com/jeevanba273/quantflow-finance)
- **Source Code**: Full source available under MIT License
- **Examples**: Comprehensive examples and tutorials included

## 📜 License

MIT License - Free for academic and commercial use.
