Stock Analysis Dashboard - User GuideWelcome! 👋This is a complete guide to help you get started with the Stock Analysis Dashboard. Everything is explained step-by-step.

🚀 Quick Start (2 minutes)Step 1: Get Your Free API Key
  1. Visit https://finnhub.io/
  2. Click "Get Free API Key" (top right)
  3. Sign up with your email (takes 30 seconds)
  4. Copy your API key from the dashboard
Step 2: Enter Your API Key
  1. Click the 🔑 API Key button (top right of dashboard)
  2. Paste your API key in the text field
  3. Click "Save API Key"
  4. Done! Your key is saved locally on your computer
Step 3: Analyze Stocks
  1. Go to the Analyzer tab
  2. Enter a stock ticker (e.g., AAPL, MSFT, TSLA)
  3. Click "Analyze"
  4. See your TA Score and Setup Score!

📊 Features ExplainedAnalyzer TabAnalyze individual stocks in detail
  • Stock Ticker Input: Type any stock symbol (AAPL, GOOGL, NVDA, etc.)
  • Current Price: Real-time stock price from Finnhub API
  • 24h Change: How much the stock price changed today
  • Daily Range: Highest and lowest price today
  • Volume: Number of shares traded today
TA Score (Technical Analysis) - /10Measures how many technical indicators are bullish:
  • 10 Indicators checked: Heikin Ashi, KAMA, Channel High, EMA9, MA50, MACD, RSI, CCI, KDJ, Stochastic
  • Scoring:
    • 9-10: Strong Buy 🚀 (very bullish)
    • 8: Buy 👍 (bullish)
    • 7: Weak Buy (mildly bullish)
    • 6: Hold ⚖️ (neutral)
    • ≤3: Strong Sell 🔥 (very bearish)
Setup ScoreMeasures momentum and relative volume:
  • RVOL: Relative Volume (today vs average)
  • % Change: Price movement percentage
  • Momentum Score: Combined strength
  • Ratings: Strong Setup 🚀, Good Setup 👍, Moderate, or Weak
Watchlist TabTrack multiple stocks automatically
  • Add stocks you want to monitor
  • See both TA Score and Setup Score for each
  • Green highlight = stock meets buy criteria
  • "BUY" badge = ready to buy signal
  • Real-time updates every 30 seconds
  • One-click removal
Settings TabCustomize notification alerts
Notification TriggersSet minimum scores that trigger alerts:
  • Minimum TA Score: 6-10 (default: 8)
  • Minimum Setup Score: 3-10 (default: 5)
  • Alert triggers when BOTH conditions are met
Notification Types
  1. Browser Pop-up: OS-level notification (requires permission)
  2. In-App Toast: Blue/green message in bottom-right corner
  3. Watchlist Glow: Green highlighting on cards
Smart Features
  • Each stock notifies once every 6 hours (prevents spam)
  • Clear notification history anytime
  • Disable/enable notifications with checkbox

🔑 API Key Setup - Detailed StepsWhat is an API Key?An API key is like a password that lets the dashboard fetch stock data. It's free and safe.
Getting Your Free API KeyStep 1: Visit Finnhub
Open: https://finnhub.io/ Step 2: Sign Up
  • Click "Get Free API Key" button
  • Enter your email
  • Check your email for verification link
  • Click the link to confirm
Step 3: Copy Your Key
  • Log in to your Finnhub account
  • Your API key appears on the dashboard
  • It looks like: d5h3vm9r01qll3dlm2sgd5h3vm9r01qll3dlm2t0
  • Click to copy (or highlight and Ctrl+C)
Step 4: Paste in Dashboard
  • Open Stock Analysis Dashboard
  • Click 🔑 API Key button (top right)
  • Paste your key in the text field
  • Click "Save API Key"
  • You see: "✓ API Key saved successfully"
Free vs Paid Plans
  • Free Plan: 60 requests per minute ✅ (plenty for personal use)
  • Paid Plans: Higher limits (not needed for this dashboard)
  • Your free plan is completely free with no credit card required
Security Note✅ Your API key is stored only on your computer
✅ Never uploaded to servers
✅ Never shared anywhere
✅ 100% private and secure

📱 How to Use - Step by StepAnalyzing a Single StockExample: Analyze Apple (AAPL)
  1. Go to Analyzer tab (already selected by default)
  2. In "Stock Ticker" field, type: AAPL
  3. Click blue "Analyze" button
  4. Wait 2 seconds for data to load
  5. See results:
    • Stock info (price, change, volume)
    • TA Score (e.g., 8/10)
    • Setup Score (e.g., 6.2)
    • Table with all 10 indicators
    • Each indicator shows: BULLISH or BEARISH
What to look for:
  • TA Score ≥ 8 = Good opportunity
  • Setup Score ≥ 5 = Strong momentum
  • Both together = Strongest signal 🚀
Building Your WatchlistExample: Watch 5 Tech Stocks
  1. Go to Analyzer tab
  2. In "Add to Watchlist" field, type: MSFT
  3. Click "Add" button
  4. You see: "✓ MSFT added to watchlist"
  5. Repeat for: GOOGL, NVDA, TSLA, META
  6. Go to Watchlist tab
  7. See all 5 stocks with live scores
  8. Updates automatically every 30 seconds
Reading the Watchlist:
  • Stock name & price: Top left
  • TA Score: First score box
  • Setup Score: Second score box
  • Green highlight: Stock meets buy criteria
  • "BUY" badge: Ready for action
  • Remove button: Delete from list anytime
Getting NotificationsTo enable alerts:
  1. Go to Settings tab
  2. Check ✓ "Enable Notifications"
  3. Set TA Score threshold: Slide to 8 (default)
  4. Set Setup Score threshold: Slide to 5 (default)
  5. You see: "TA Score ≥ 8/10 AND Setup Score ≥ 5"
  6. Save! (happens automatically)
What happens next:
When a stock in your watchlist meets BOTH criteria:
  • You get a browser pop-up (might need to allow first)
  • You see a green toast notification in dashboard
  • Stock card glows green
  • "BUY" badge appears
Each stock alerts once every 6 hours (even if criteria met again)

⚙️ Advanced SettingsAdjusting Alert SensitivityMore Conservative (fewer alerts):
  • TA Score: 9 or 10
  • Setup Score: 6 or higher
  • Only strongest signals
More Aggressive (more alerts):
  • TA Score: 7 or 8
  • Setup Score: 4 or 5
  • Catch more opportunities
Clearing Notification History
  • Go to Settings tab
  • Click "Clear Notification History"
  • Stocks can now notify you again immediately
  • Useful if you want to reset all alerts
Changing Your API Key
  • Click 🔑 API Key button
  • Clear the field and enter a new key
  • Click "Save API Key"
  • Switch to different Finnhub account anytime

❓ FAQ & Troubleshooting"API Key not set" ErrorSolution:
  1. Click 🔑 API Key button
  2. Make sure you pasted the key completely
  3. Click "Save API Key"
  4. Try analyzing again
Stock Not FoundSolution:
  • Check spelling (e.g., "AAPL" not "Apple")
  • Use official ticker symbols only
  • Try: AAPL, MSFT, GOOGL, TSLA, META, NVDA
No Notifications AppearingSolution:
  1. Check Settings tab - notifications enabled?
  2. Browser might block notifications - allow in settings
  3. Make sure TA and Setup scores meet thresholds
  4. Recent notifications hidden for 6 hours
Dashboard Runs SlowlySolution:
  • Remove unused stocks from watchlist
  • Refresh page (Ctrl+R or Cmd+R)
  • Close other browser tabs
  • Fewer than 10 stocks is ideal
Data Not UpdatingSolution:
  • Click the stock again to refresh
  • Watchlist auto-updates every 30 seconds
  • Manually switch tabs to force refresh

🎯 Best Practices1. Start Small
  • Analyze 3-5 stocks first
  • Get familiar with the interface
  • Then build larger watchlist
2. Set Realistic Thresholds
  • Don't set TA Score to 10 (almost never happens)
  • TA Score 8-9 is realistic
  • Setup Score 5+ is good middle ground
3. Watch Trending Stocks
  • Add stocks that interest you
  • Tech sector tends to be more volatile
  • Check watchlist during market hours
4. Regular Monitoring
  • Check dashboard 1-2 times daily
  • During market opening (9:30 AM) is best
  • Momentum changes throughout the day
5. Combine with Your Research
  • Use these scores alongside your own analysis
  • Don't rely on scores alone
  • Check news and fundamentals too

🔐 Privacy & SecurityThis dashboard is completely private:
  • ✅ No accounts or registration needed
  • ✅ No data sent to servers
  • ✅ No tracking or analytics
  • ✅ API key stored locally only
  • ✅ Watchlist stored on your computer
  • ✅ Settings saved in browser only
  • ✅ Open source - you can see the code
Your data is yours:
  • Delete everything by clearing browser data
  • Copy this HTML file to any computer
  • Use multiple devices independently

📚 Technical DetailsWhat Each Score MeansTA Score (Technical Analysis)
  • Looks at 10 different technical indicators
  • Counts how many show bullish signals
  • Score ranges from 0-10
  • Based on common trading indicators
Setup Score (Momentum)
  • Measures price change and volume
  • Higher volume on up days = stronger setup
  • Combines RVOL (relative volume) + momentum
  • Ranges typically 0-10
Indicators Used (TA Score)
  1. Heikin Ashi: Smoothed candle patterns
  2. KAMA: Kaufman's Adaptive Moving Average
  3. Channel High: Support/resistance levels
  4. EMA9: 9-day Exponential Moving Average
  5. MA50: 50-day Simple Moving Average
  6. MACD: Moving Average Convergence Divergence
  7. RSI: Relative Strength Index (overbought/oversold)
  8. CCI: Commodity Channel Index
  9. KDJ: Stochastic oscillator
  10. Stochastic 14,3,3: Momentum indicator

🎓 Learning ResourcesUnderstand Technical Analysis
  • https://www.investopedia.com/articles/forex/09/technical-analysis.asp
  • YouTube: "Technical Analysis for Beginners"
Stock Market Basics
  • https://www.investopedia.com/
  • https://www.khanacademy.org/economics-finance-domain/finance-and-capital-markets
Finnhub API Documentation
  • https://finnhub.io/docs/api

💡 Tips & TricksKeyboard Shortcuts
  • Press ESC to close API Key modal
  • Click stock price to see details (some browsers)
  • Ctrl+R (Windows) or Cmd+R (Mac) to refresh page
Quick Ticker Lookup
  • US stocks: AAPL, MSFT, GOOGL, TSLA, AMZN, NVDA
  • European: SAP, ASML, UNIQLO (9983.T)
  • Mix and match across markets
Optimal Settings for Different StrategiesDay Trading (aggressive)
  • TA: 7, Setup: 4
  • Watch stocks with high momentum
Swing Trading (moderate)
  • TA: 8, Setup: 5
  • Watch for strong technical setups
Long-term (conservative)
  • TA: 9, Setup: 6
  • Wait for confirmed strong trends

🤝 Support & FeedbackIf Something Doesn't Work
  1. Clear browser cache: Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
  2. Refresh page: Ctrl+R or Cmd+R
  3. Check API key: Make sure it's still valid
  4. Try different stock: Test with AAPL first
  5. Restart browser: Close and reopen
Feature Requests
  • This is an open-source project
  • Ideas for improvements welcome
  • Share what would make it better for you

🎉 You're All Set!You now know:
  • ✅ How to get a free API key
  • ✅ How to set up the dashboard
  • ✅ How to analyze stocks
  • ✅ How to build a watchlist
  • ✅ How to get notifications
  • ✅ How to interpret the scores
Start exploring! Pick a stock and click "Analyze" 🚀

Quick Reference CardFeatureLocationHow to UseAnalyze StockAnalyzer TabEnter ticker → Click Analyze
Add to WatchlistAnalyzer TabEnter ticker → Click Add
View WatchlistWatchlist TabSee all tracked stocks
Set AlertsSettings TabAdjust sliders → Auto saves
API Key🔑 ButtonPaste key → Save
Get HelpThis GuideYou're reading it!
Happy Trading! 📈
Last Updated: April 2026 Dashboard Version: 1.0

swingstocktraders