Risk & Portfolio Glossary
Quick Reference: Key Terms
25 essential terms with plain-English definitions
Portfolio Health Score
A 0–100 score (model portfolio_health_score@2.1.0) combining six weighted convex penalties: volatility, tail risk (CVaR), concentration (largest-position and top-5 weight), correlation stress, drawdown, and data confidence (a data-quality proxy covering history depth, outliers, and coverage — NOT market liquidity). Higher is better.
Concentration Risk
When too much of your portfolio is in one stock or sector. If that holding drops, your whole portfolio is hurt.
Correlation
How closely two assets move together. High correlation = they tend to rise and fall at the same time, reducing diversification benefit.
Drawdown
The drop from a portfolio's peak value to its lowest point before recovery. A 20% drawdown means you lost 20% from your high.
Max Drawdown
The largest historical decline from peak to trough. Used to understand worst-case historical performance.
VaR (Value at Risk)
The maximum loss you'd expect on 95% of trading days. Doesn't tell you how bad the worst 5% of days could be.
CVaR / Expected Shortfall
The average loss in the worst 5% of scenarios. More informative than VaR for tail risk.
Volatility
How much an asset's price fluctuates. Annualized volatility of 20% means the asset typically swings ±20% over a year.
Beta
How sensitive your portfolio is to market moves. Beta of 1.2 means you move 20% more than the market.
Alpha
Return above (or below) what the market would explain. Positive alpha means you outperformed on a risk-adjusted basis.
Sharpe Ratio
Return per unit of risk taken. Higher Sharpe = better risk-adjusted performance.
Market Regime
The current "state" of markets: Risk-On (bullish), Risk-Off (defensive), Volatile, or Transitioning.
Decision Readiness Score (DRS)
Measures whether your current emotional and analytical state is well-suited for making portfolio decisions. Considers overtrading history, rule violations, and market stress.
Tail Risk
The risk of extreme, unlikely events causing large losses — the "tails" of the return distribution.
Rebalancing
Adjusting your portfolio back to target allocations after drift from price changes.
Diversification Ratio
A measure of how much risk-reduction benefit your asset mix provides. Higher ratio = better diversification.
Liquidity Risk
The risk that you can't sell an asset quickly at a fair price when you need to.
Guardrail
A personal limit you set (e.g., max 40% in one stock) that the system monitors. Not enforced — purely observational alerts.
Factor Exposure
How much your portfolio is tilted toward growth, value, quality, momentum, or other return-driving characteristics.
Stress Test
Deterministic application of a fixed shock vector per scenario (e.g. 2008 GFC, COVID 2020 crash, 2022 rate shock, liquidity shock) to your current positions, where the headline equals the sum of holding-level impacts. A separate heuristic uses scenario/regime correlation assumptions for illustrative context; it does not change the headline or establish a measured loss reduction. The same complete inputs and model version produce the same numerical result. Not a probability simulation — it does not draw random paths and does not use Student-t or Cholesky.
Monte Carlo Simulation
Probabilistic path simulation that draws thousands of possible future return paths using Cholesky-correlated shocks (with optional Student-t fat tails) and reports the resulting outcome distribution. Different from a Stress Test — Monte Carlo is probabilistic, the Stress Test is a deterministic shock scenario.
Scenario Comparison
Placing two portfolio states side-by-side to see how a proposed change would affect risk and return metrics.
Tax-Loss Harvesting
Selling losing positions to realize losses that offset gains elsewhere, potentially reducing your tax bill.
CAGR (Compound Annual Growth Rate)
Your annualized return, accounting for compounding. More accurate than simple averages over multiple years.
Decision Cost Index (DCI)
A comparison of the potential cost (drawdown × recovery time) of acting now vs. waiting, expressed as a relative score.
Mini-Courses
Quick educational modules on key investment concepts
Data Sources & Freshness
Where your data comes from and how often it updates
- •Live Prices — Fetched from financial data providers (Yahoo Finance, Finnhub, Polygon) when you load a page or click "Refresh." Prices may be 15-minute delayed for free data.
- •Market News — Pulled from Benzinga, NewsAPI, and Finnhub. Refreshes every 2 minutes. Articles are scored for sentiment.
- •Portfolio Snapshots — Captured after every price refresh to track your portfolio's value over time. Used for historical performance charts.
- •Benchmarks — Multiple regional indices available: S&P 500, NASDAQ, Tadawul (TASI), DFM, CAC 40, and more. Configurable in Settings.
- •Daily Change vs Total P/L — "Today's Change" compares current price to yesterday's close. "Total P/L" shows gain/loss since purchase date.
Portfolio & Performance Metrics
Understanding your holdings and returns
- •Portfolio Value — The total current market value of all your holdings (current price × quantity for each position).
- •Unrealized P/L — Your paper profit or loss across all positions. "Unrealized" because you haven't sold yet.
- •CAGR (Compound Annual Growth Rate) — Your annualized return accounting for compounding. More accurate than simple average returns for multi-year periods.
- •Allocation % — How much of your total portfolio each position represents. A 40% allocation means that stock is 40% of your portfolio value.
- •Outperformance (Alpha) — The difference between your portfolio return and the benchmark return. Positive = you beat the market.
- •Contributors/Detractors — Positions that added most to (or subtracted most from) your total return.
Risk, Volatility & Concentration
Measuring how risky your portfolio is
- •Max Drawdown — The largest drop your portfolio experienced from a peak to the next low. Answers: "From the highest point, how bad did it get?"
- •Annualized Volatility — How much your portfolio typically moves up or down over a year. Higher volatility = bigger swings.
- •1-Day 95% VaR — The loss you should not exceed on 95% of trading days. See the VaR mini-course above for details.
- •Portfolio Beta — How sensitive your portfolio is to overall market moves. Beta of 1.2 means estimated sensitivity of 1.2 times a benchmark move, not 20% more total volatility.
- •Concentration Risk — When a large portion of your portfolio is in one stock. Generally, if a single position exceeds 30-40%, you're "concentrated."
- •Risk Regime (Risk-On / Defensive) — Overall portfolio tilt. "Risk-On" means growth/aggressive positions dominate. "Defensive" means stable, low-volatility positions.
Factor & Regime Analysis
Understanding what's driving your portfolio
- •Factor Bucket — Classifies each holding: Growth, Quality, Momentum, Defensive, Cyclical, etc. See the Factor mini-course above.
- •Regime Bucket — Classifies each holding's risk posture: RiskOnAggressive, RiskOn, RiskOnCore, Neutral, Defensive. Used as a contextual signal; not an input to the Risk Score.
- •Risk Score (0-100) — Model
risk_score@3.0.0. Percentile rank of the portfolio's annualised volatility against an SPY-based historical distribution. Bands: Defensive (0–25), Balanced (26–50), Aggressive (51–75), Speculative (76–100). A data-confidence band (driven by return-history length and position-count completeness) is shown alongside. CVaR, max drawdown, beta, and Student-t tail metrics are displayed as separate Risk Metrics — they are not inputs to this score. Volatility is a symmetric, non-coherent risk measure (Artzner et al. 1999); tail and path risks are reported separately by design. Closest regulatory analogue: ESMA SRRI (UCITS KIID) / PRIIPs Market Risk Measure. - •Duration (Bonds) — Sensitivity to interest rate changes. Higher duration = more sensitive. A bond with 7-year duration falls ~7% if rates rise 1%.
Macro & Market Analysis
Economic indicators and market regime
- •Yield Curve — Plots interest rates across maturities (2Y to 30Y). Normal = upward sloping. Inverted = short rates higher than long rates (recession signal).
- •2Y/10Y Spread — Difference between 10-year and 2-year Treasury yields. Negative spread (inversion) historically precedes recessions.
- •VIX (Volatility Index) — "Fear gauge" measuring expected S&P 500 volatility. VIX > 30 = high fear. VIX < 15 = complacency.
- •Macro Regime — Current economic environment classification: Risk-On (bullish growth), Neutral, Risk-Off (defensive), Inflation-Stress.
Tax & Rebalancing
Optimizing your portfolio
- •Tax-Loss Harvesting — Selling losing positions to realize losses that offset gains. Reduces tax bill while maintaining exposure via similar securities.
- •Wash Sale Rule — IRS rule: if you (or your spouse / a controlled entity) buy a substantially identical security within 30 days before or after realising a loss — a 61-day window in total — the loss is disallowed and added to the cost basis of the replacement shares.
- •Rebalancing — Adjusting portfolio back to target allocations. If growth stocks outperform and become 60% of your portfolio (target was 40%), rebalancing would trim growth and add to underweight positions.
- •Drift Tolerance — How far you let allocations drift before rebalancing. Typically 3-5% before taking action.
Signals & Sentiment
Market indicators and news analysis
- •Market Signals — AI-generated insights based on current market data, news, and index movements. Categories: Macro, Technical, Sentiment, Sector, Risk.
- •Sentiment Score — Measure of whether news about a stock is positive or negative. Calculated from keywords in headlines.
- •Breaking News Alerts — Real-time notifications when significant news affects your holdings.
- •Price Alerts — Notifications you set to trigger when a stock hits a target price. Delivered via push notification, email, or in-app.
Behavioral Analytics
Understanding your trading patterns
- •Trade Journal — Log of your investment decisions with reasons and outcomes. Helps identify patterns and improve decision-making.
- •Behavioral Score — Rating of your trading discipline based on journal entries. Higher score = better adherence to strategy.
- •Common Biases Detected — AI identifies patterns like panic selling, FOMO buying, overtrading, revenge trading, and concentration bias.
- •AI Portfolio Doctor — Health assessment of your portfolio identifying issues like stale data, missing classifications, or goal misalignment.
Have questions about other metrics? Ask the AI Assistant for clarification.
