{"id":51253453,"url":"https://github.com/mr-vaibh/galedge","last_synced_at":"2026-06-29T08:30:43.710Z","repository":{"id":353793392,"uuid":"1220909682","full_name":"mr-vaibh/galedge","owner":"mr-vaibh","description":"Factor models, portfolio optimization, backtesting, and live rebalancing — built on NSE data. Includes a 21-factor risk model, CVXPY-powered optimizer, Python research sandbox (VS Code in browser), Brinson attribution, and strategy builder with trade list generation.   Full-stack: Next.js 16 + FastAPI + SQLite.","archived":false,"fork":false,"pushed_at":"2026-05-27T13:12:57.000Z","size":14398,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T15:11:23.645Z","etag":null,"topics":["backtesting","cvxpy","factor-models","fastapi","fintech","indian-markets","nextjs","nse","portfolio-optimization","python","quantitative-finance","systematic-investing"],"latest_commit_sha":null,"homepage":"https://galedge.byvaibhav.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mr-vaibh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T13:55:10.000Z","updated_at":"2026-05-27T13:13:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mr-vaibh/galedge","commit_stats":null,"previous_names":["mr-vaibh/galedge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mr-vaibh/galedge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Fgaledge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Fgaledge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Fgaledge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Fgaledge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mr-vaibh","download_url":"https://codeload.github.com/mr-vaibh/galedge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-vaibh%2Fgaledge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34919882,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-29T02:00:05.398Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backtesting","cvxpy","factor-models","fastapi","fintech","indian-markets","nextjs","nse","portfolio-optimization","python","quantitative-finance","systematic-investing"],"created_at":"2026-06-29T08:30:42.909Z","updated_at":"2026-06-29T08:30:43.704Z","avatar_url":"https://github.com/mr-vaibh.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Galedge -- Free Stock Market Data Platform\n\nFree, open-source stock market data platform with real-time prices, interactive charts, options chains, fundamentals, insider trades, analyst ratings, and more. Supports US (170+ stocks) and Indian (NSE/BSE, 50+ stocks) markets. Built with Next.js, FastAPI, and yfinance.\n\n## Features\n\n- **Real-time stock quotes and OHLCV data** -- live prices with automatic polling, historical candlestick data at multiple intervals (1m to monthly)\n- **Interactive candlestick charts with technical indicators** -- RSI, MACD, Bollinger Bands, SMA, EMA overlaid on lightweight-charts\n- **Stock comparison** -- overlay normalized performance charts and view side-by-side fundamentals for multiple tickers\n- **Stock screener** -- filter stocks by sector, P/E ratio, dividend yield, market cap, and more\n- **Market heatmap** -- finviz-style treemap visualization sized by market cap, colored by daily change\n- **Correlation matrix** -- Pearson correlation of daily returns across selected stocks\n- **Portfolio tracker** -- track holdings with live P\u0026L calculations (localStorage-based, no signup required)\n- **Options chain viewer** -- calls and puts with implied volatility, open interest, and Greeks\n- **Fundamentals** -- key stats, income statements, balance sheets, and cash flow (annual and quarterly)\n- **Market intelligence** -- insider trades, institutional holders, analyst recommendations, and news\n- **CSV export** -- export data from any table view\n- **Indian stock support** -- NSE and BSE listed stocks with .NS and .BO suffixes\n- **CLI tool** -- data pipeline for fetching, storing, and viewing market data as compressed Parquet files\n\n## Screenshots\n\nScreenshots coming soon.\n\n## Tech Stack\n\n- **Frontend**: Next.js 16, React 19, TypeScript, Tailwind CSS v4, shadcn/ui, lightweight-charts\n- **Backend**: FastAPI, Python, yfinance, pandas, numpy\n- **CLI**: Python, yfinance, pandas, pyarrow (compressed Parquet storage)\n- **No database** -- all data fetched live from Yahoo Finance\n\n## Project Structure\n\n```\ngaledge/\n  backend/           # FastAPI server -- REST API for market data\n    main.py          # API routes and endpoints\n    requirements.txt\n  frontend/          # Next.js web application\n    src/\n    package.json\n  packages/\n    galedge-core/    # CLI tool and Python library\n      galedge/       # Core modules (fetcher, storage, options, fundamentals, intel, live)\n      tests/         # Test suite (80 tests)\n      pyproject.toml\n```\n\n## Getting Started\n\n```bash\n# Clone\ngit clone https://github.com/yourusername/galedge.git\ncd galedge\n\n# Backend\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -e packages/galedge-core\npip install -r backend/requirements.txt\ncd backend \u0026\u0026 uvicorn main:app --port 8001 --reload\n\n# Frontend (new terminal)\ncd frontend\nnpm install\nnpm run dev\n\n# Open http://localhost:3000\n```\n\n## CLI Usage\n\nThe `galedge` CLI lets you fetch and explore market data directly from the terminal:\n\n```bash\n# Fetch 6 months of daily data\ngaledge fetch AAPL MSFT RELIANCE.NS -i 1d -p 6mo\n\n# View stored data as a colored table\ngaledge show AAPL -t -n 20\n\n# Watch live prices (polls every 15 seconds)\ngaledge live AAPL MSFT GOOGL -s 15\n\n# Options chain\ngaledge options AAPL -k puts\n\n# Fundamentals (key stats, income statement, balance sheet, cash flow)\ngaledge fundamentals AAPL\ngaledge fundamentals AAPL -s balance_sheet\n\n# Market intelligence (insider trades, analysts, news)\ngaledge intel AAPL\ngaledge intel AAPL -k news\n```\n\nSee [packages/galedge-core/README.md](packages/galedge-core/README.md) for full CLI documentation.\n\n## API Docs\n\nWhen the backend is running, interactive Swagger documentation is available at:\n\nhttp://localhost:8001/docs\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n\n## Disclaimer\n\nThis project is for educational and informational purposes only. It is not financial advice. Stock data is sourced from Yahoo Finance via yfinance and may be delayed or inaccurate. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-vaibh%2Fgaledge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr-vaibh%2Fgaledge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-vaibh%2Fgaledge/lists"}