Skip to content

divyansh1920/quantalpha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 

Repository files navigation

QuantAlpha ๐Ÿ“Š

Because great investing starts with great information.

React Vite TailwindCSS Deployed Markets

Live Site โ†’ https://divyansh1920.github.io/quantalpha


What Is QuantAlpha?

Most retail investors in India make decisions based on tips, social media, and gut feeling โ€” not data.

QuantAlpha fixes that.

It is a free, no-login, fully browser-based stock intelligence platform that gives any investor โ€” whether they're just starting out or have years of experience โ€” the same analytical toolkit used by professional fund managers. Enter any stock ticker from the Indian (NSE) or US market and receive a complete financial analysis in under 10 seconds.

No Bloomberg terminal required. No expensive subscription. Just a ticker and a browser.


Who Is This For?

  • ๐ŸŽ“ MBA & Finance students learning to apply valuation frameworks on real data
  • ๐Ÿ“ˆ Retail investors in India tired of making decisions without proper analysis
  • ๐Ÿ’ผ Professionals who want a quick sanity check before investing
  • ๐Ÿง  Beginners who want to learn investing through real companies, not textbooks

What Makes It Different?

Feature QuantAlpha Most Free Tools
Indian NSE stocks โœ… Full support โŒ Rare
AI Investment Score โœ… 5-dimension, 0โ€“100 โŒ
DCF Intrinsic Value โœ… Two-stage model โŒ
Plain-English interpretation โœ… Per metric, per company โŒ
Education with real case studies โœ… Enron, Buffett, Lehman โŒ
Sign-up required โŒ Never Often
Cost โŒ Free forever Often paid

Core Features

๐Ÿ” Live Stock Analysis

Enter any NSE or NYSE/NASDAQ ticker and get a full financial report powered by live market data. Works for RELIANCE.NS, TCS.NS, AAPL, NVDA and thousands more.

๐Ÿค– AI Investment Score (0โ€“100)

A proprietary normalized scoring engine evaluates every company across 5 dimensions:

  • Profitability โ€” ROE, Net Margin, ROA, Gross Margin
  • Valuation โ€” P/E, P/B, EV/EBITDA
  • Growth โ€” Revenue & EPS year-over-year growth
  • Financial Health โ€” Debt/Equity, Current Ratio, Interest Coverage
  • Cash Flow โ€” FCF positivity and FCF growth

Scores are normalized โ€” meaning if data is unavailable for some metrics, the score is calculated fairly based only on available data. No more artificially low scores due to missing fields.

๐Ÿ’ฐ DCF Intrinsic Value Model

A two-stage Discounted Cash Flow model estimates the intrinsic value per share using historically observed FCF growth rates, a 10% WACC, and 2.5% terminal growth. Displays full projection table, present values, and margin of safety label.

๐Ÿ“– Metric Interpreter (Learning Mode)

A collapsible panel on every analysis page explains what each metric actually means for this specific company โ€” using the real numbers, in plain English. Designed to teach, not just display.

๐Ÿ”Ž Strategy-Based Screener

Curated stock lists for 4 proven investment strategies across both US and Indian markets:

  • Value Investing โ€” Low P/E, low P/B, strong FCF
  • Growth Investing โ€” High revenue growth, expanding margins
  • Dividend Investing โ€” Consistent dividend payers
  • Quality Investing โ€” High ROE, strong moats, low debt

๐Ÿ“‚ Portfolio Builder

Add up to 8 stocks (US or Indian), compare AI scores side by side, view market cap weight distribution, and get a combined portfolio score. Includes 6 preset portfolios across both markets.

๐ŸŽ“ Investor Education Hub

5 learning modules with 15+ in-depth lessons, real-world case studies, and a YouTube video lecture section:

  • Stock Market Basics โ€” The ownership mindset, Mr. Market, market cap
  • Valuation Ratios โ€” P/E, P/B, EV/EBITDA, full DCF walkthrough with Coca-Cola
  • Profitability Metrics โ€” ROE, Free Cash Flow, DuPont analysis
  • Risk & Financial Health โ€” Debt, liquidity, interest coverage
  • Investment Strategies โ€” Value, growth, dividend with Buffett, Lynch, Graham

Every lesson uses real case studies โ€” Enron's FCF fraud, Toys R Us debt collapse, Lehman Brothers liquidity crisis, Buffett's Goldman Sachs trade.


Tech Stack

Frontend    React 18 + Vite 5
Styling     Tailwind CSS v3
Charts      Recharts
Routing     React Router DOM v6
HTTP        Axios
Icons       Lucide React
Deployment  GitHub Pages (gh-pages)

Zero backend. Zero database. Zero server costs.


Data Sources

Source Used For Plan
Financial Modeling Prep US stock profiles, financials, ratios, DCF Free (250 req/day)
Twelve Data Indian NSE stock prices & history Free (800 credits/day)
Alpha Vantage Technical indicators (RSI, MACD) Free (25 req/day)

Indian Market Support ๐Ÿ‡ฎ๐Ÿ‡ณ

QuantAlpha was built with the Indian investor in mind. NSE-listed stocks are fully supported using the .NS suffix:

RELIANCE.NS    TCS.NS    HDFCBANK.NS    INFY.NS
ZOMATO.NS      TITAN.NS  BAJFINANCE.NS  ASIANPAINT.NS
  • Live prices via Twelve Data (NSE feed)
  • Financial statements via FMP v3 (where available)
  • Full analysis page โ€” charts, DCF, scoring โ€” same as US stocks

Local Setup

# Clone
git clone https://github.com/divyansh1920/quantalpha.git
cd quantalpha

# Install
npm install

# Add API keys โ€” create .env in root folder:
VITE_FMP_API_KEY=your_key_here
VITE_ALPHA_VANTAGE_KEY=your_key_here
VITE_TWELVE_DATA_KEY=your_key_here

# Run development server
npm run dev

Visit: http://localhost:5173/quantalpha/

Get free API keys from:


Deploy to GitHub Pages

npm run deploy

Builds the project and pushes to the gh-pages branch automatically.


Project Structure

src/
โ”œโ”€โ”€ api/
โ”‚   โ”œโ”€โ”€ fmp.js              US stock data (FMP Stable API)
โ”‚   โ”œโ”€โ”€ twelvedata.js       Indian stock prices + OHLCV
โ”‚   โ””โ”€โ”€ alphavantage.js     Technical indicators
โ”œโ”€โ”€ components/
โ”‚   โ”œโ”€โ”€ Navbar.jsx
โ”‚   โ”œโ”€โ”€ Loader.jsx
โ”‚   โ”œโ”€โ”€ MetricCard.jsx
โ”‚   โ”œโ”€โ”€ MetricInterpreter.jsx
โ”‚   โ””โ”€โ”€ ScoreGauge.jsx
โ”œโ”€โ”€ context/
โ”‚   โ””โ”€โ”€ StockContext.jsx    Global state + US vs India routing
โ”œโ”€โ”€ pages/
โ”‚   โ”œโ”€โ”€ Home.jsx            Landing + search + market toggle
โ”‚   โ”œโ”€โ”€ Analysis.jsx        Full 9-section company report
โ”‚   โ”œโ”€โ”€ Screener.jsx        Strategy screener (US + India)
โ”‚   โ”œโ”€โ”€ Portfolio.jsx       Multi-stock portfolio builder
โ”‚   โ””โ”€โ”€ Education.jsx       Learning hub with video support
โ””โ”€โ”€ utils/
    โ”œโ”€โ”€ scoring.js          Normalized AI scoring engine
    โ”œโ”€โ”€ dcf.js              Two-stage DCF model
    โ””โ”€โ”€ formatters.js       Currency, percent, ratio formatters

Roadmap

  • NSE screener with live fundamental filters
  • Technical analysis tab (RSI, MACD charts)
  • Peer comparison โ€” 2 companies side by side
  • Watchlist saved to localStorage
  • Earnings calendar
  • Export analysis report to PDF
  • Nifty 50 / Sensex index overview dashboard
  • PWA support โ€” install on mobile home screen

Disclaimer

QuantAlpha is built for educational and informational purposes only. Nothing on this platform constitutes financial advice or a recommendation to buy or sell any security. Always conduct your own research. Past performance does not guarantee future results. Investing involves risk of loss.


Author

Built by Divyansh Jain โ€” MBA Finance, FORE School of Management

Combining financial domain knowledge with modern web development to make institutional-grade investment research accessible to everyone.


ยฉ 2025 QuantAlpha ยท Free ยท Open Source ยท Built for Indian Investors ๐Ÿ‡ฎ๐Ÿ‡ณ

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages