Investment Scorer is an intelligent stock analysis platform designed to give traders a clear edge. It instantly calculates a comprehensive Investment Score (1-100) for any stock or ETF by synthesizing Technical Analysis, Fundamental Data, and Market Sentiment into a single actionable metric.
Whether you are a day trader or long-term investor, Investment Scorer helps you cut through the noise with clear Buy/Sell recommendations, real-time data, and AI-driven insights.
- Investment Score (1-100): Comprehensive scoring based on 15+ technical indicators
- Technical Analysis: RSI, MACD, Bollinger Bands, Stochastic, Williams %R, CCI, ADX, MFI, OBV, VWAP
- Fundamental Analysis: P/E, PEG, Profit Margins, Revenue Growth, ROE, Debt/Equity
- Market Sentiment: VIX, Treasury Yields, S&P 500 trends
- Stock Screener: Find strong buys, sells, and short opportunities
- Price Targets: Entry, exit, and stop-loss levels
- Earnings Data: Historical earnings surprises and analyst targets
# Install dependencies
pip install -r requirements.txt
# Run the server
python app.py
# Open browser to http://localhost:8080This project is configured for Daytona cloud development environments.
- Daytona CLI installed
- Daytona account configured
# Create a new workspace
daytona create https://github.com/YOUR_USERNAME/investment-scorer
# Or from local directory
daytona create .
# The workspace will automatically:
# 1. Set up Python 3.11 environment
# 2. Install all dependencies
# 3. Start the Flask server on port 8080
# 4. Forward ports for browser accessThe project includes:
.devcontainer/devcontainer.json- Dev container configuration.daytona/config.yaml- Daytona workspace settingsdocker-compose.yml- Multi-service orchestrationDockerfile- Production-ready container
POST /api/analyze
Content-Type: application/json
{"ticker": "AAPL"}GET /api/screen?filter=strong_buys&limit=20
# Filters: all, strong_buys, buys, sells, strong_sells, shortsGET /api/market-sentimentThe investment score combines:
- 65% Technical Score (weighted average of indicators)
- 35% Fundamental Score (earnings, margins, growth)
| Score | Recommendation | Action |
|---|---|---|
| 75-100 | STRONG BUY | Long with high confidence |
| 60-74 | BUY | Long with medium confidence |
| 45-59 | HOLD | Wait for clearer signals |
| 30-44 | SELL | Short with medium confidence |
| 1-29 | STRONG SELL | Short with high confidence |
| Indicator | Weight | Description |
|---|---|---|
| Candlestick Patterns | 16% | Pattern detection and trend analysis |
| Earnings | 10% | Historical earnings surprises |
| Moving Averages | 9% | SMA 20/50/200, Golden/Death Cross |
| VIX | 8% | Market fear gauge |
| RSI | 7% | Relative Strength Index (14-period) |
| MACD | 7% | Moving Average Convergence Divergence |
| News Sentiment | 7% | NLP-based news sentiment |
| ADX | 5% | Average Directional Index (trend strength) |
| Bollinger Bands | 5% | Price position within bands |
| Stochastic | 5% | Stochastic Oscillator |
| MFI | 4% | Money Flow Index |
| OBV | 4% | On-Balance Volume |
| Williams %R | 3% | Overbought/oversold |
| CCI | 3% | Commodity Channel Index |
| VWAP | 3% | Volume Weighted Average Price |
| Consumer Sentiment | 4% | Retail sentiment analysis |
The landing page now features a comprehensive Market Snapshot:
- Market Sentiment Bar: VIX, Fear/Greed Index, S&P 500 trend, Treasury yields
- Top BUY Signals: Stocks with highest investment scores
- Short Candidates: Stocks with lowest scores for short opportunities
- Daily Movers: Biggest gainers and losers
- Market News: Aggregated news with sentiment analysis
- Click any stock to view detailed charts and analysis
# Market Snapshot (all data in one call)
GET /api/snapshot
# Stock chart and details
GET /api/stock/AAPL/chart
# Stock detail page
GET /stock/AAPLInvestment Scorer is a Progressive Web App (PWA). You can install it directly to your home screen on iOS, Android, macOS, and Windows for a full-screen, native, and offline-capable experience.
- Open the website in Safari
- Tap the Share button (square with arrow up)
- Scroll down and tap "Add to Home Screen"
- Tap "Add" in the top right
- Open the website in Chrome
- Tap the Menu button (three dots)
- Tap "Install app" or "Add to Home Screen"
- Confirm by tapping "Install"
- Open the website in your browser
- Look for the Install icon (monitor with arrow) in the address bar (right side)
- Click "Install"
- The app will launch in its own window via Chrome/Edge
- Offline Support: Static assets are cached for offline access
- Native App Experience: Runs in standalone mode without browser UI
- Touch Optimized: Dark theme UI designed for mobile
- Real-Time Data: API calls always fetch fresh market data
This tool is for educational purposes only. The investment score and recommendations are based on technical and fundamental analysis and should not be considered financial advice. Always do your own research and consult with a qualified financial advisor before making investment decisions.
MIT