Portfolio Analyzer - Parallax API

Transform your existing holdings into actionable insights. The Portfolio Analyzer applies institutional-grade quantitative methods to any portfolio, providing the same level of analysis used by billion-dollar endowments and hedge funds. Most investment tools focus on picking new stocks. The Portfolio Analyzer starts with what you already own, then reveals hidden risks, optimization opportunities, and performance drivers using rigorous academic methodology.

Conceptual Foundation

The Portfolio-First Approach

Traditional investment analysis often examines securities in isolation. Modern Portfolio Theory, developed by Harry Markowitz in 1952, demonstrated that portfolio-level analysis is fundamental—the risk and return of individual holdings matter less than how they work together. Key Principles:

Diversification Benefits: How holdings correlate affects total portfolio risk
Factor Exposure: Securities share common risk factors (value, growth, size, quality)
Performance Attribution: Understanding what drives returns enables better decisions
Optimization Opportunities: Mathematical methods can improve risk-adjusted returns

Getting Started

Uploading Your Portfolio

Supported Formats
Required Fields

CSV Files: Standard comma-separated format
Excel Files: .xlsx and .xls formats supported
Manual Entry: For smaller portfolios or quick analysis
Broker Integration: Direct connection to select platforms (where available)

Sample Portfolio Format

Date,Symbol,Weight
2023-01-15,AAPL,0.25
2023-02-20,MSFT,0.20
2023-03-10,GOOGL,0.15
2023-01-30,VTI,0.40

Portfolio Upload Process

Access the Analyzer

Navigate to the Analyzer tab in your dashboard

Choose Upload Method

File upload, manual entry, or broker connection

Map Data Fields

Confirm that columns are correctly identified

Review Holdings

Verify that securities are properly recognized

Initiate Analysis

Click “Analyze Portfolio” to begin processing

Processing Time: Most portfolios analyze in 30-60 seconds. Complex portfolios with many international holdings may take up to 2 minutes.

Understanding Your Analysis

Overview Tab: Portfolio Summary

Portfolio Metrics Dashboard

Metric	Description
Total Portfolio Value	Current market value of all holdings
Total Return	Performance since portfolio inception or specified period
Sharpe Ratio	Risk-adjusted return measurement
Volatility	Portfolio standard deviation
Beta	Market sensitivity
Maximum Drawdown	Largest peak-to-trough decline
Parallax Score	Proprietary composite score (0-100) evaluating overall portfolio quality

Asset Allocation Breakdown:

Sector allocation with over/underweights vs. market
Geographic distribution
Market cap distribution
Growth vs. value tilt

Performance Tab: Return Analysis

Time-Period Analysis

Returns Across Multiple Periods:

1 Day, 1 Week, 1 Month, 3 Month, 6 Month, 1 Year, 3 Year
Comparison to relevant benchmarks (S&P 500, total market, custom)
Risk-adjusted performance metrics for each period

Performance Attribution

Understanding What Drives Returns:

Component	Description
Security Selection	How individual stock picks contributed to performance relative to sector averages
Sector Allocation	Impact of being overweight or underweight in specific sectors
Factor Exposure	Contribution from value, growth, momentum, quality, and size factors
Currency Impact	For international holdings, effect of currency movements

Example Attribution Analysis:

Total Portfolio Return: +12.3% (vs. S&P 500: +8.7%)
  Security Selection: +2.1%
  Sector Allocation: +1.8%
  Factor Tilts: +1.2%
  Currency/Other: -1.5%

Risk Tab: Comprehensive Risk Assessment

Traditional Risk Metrics

Volatility Analysis:

Annualized standard deviation
Downside deviation (volatility of negative returns)
Tracking error vs. benchmark

Value at Risk (VaR): Statistical measure of potential losses over specific time horizons with given confidence levels.

1-day 95% VaR: “95% confident you won’t lose more than X% in one day”
1-month 99% VaR: More extreme scenario analysis

Advanced Risk Decomposition

Factor Risk Attribution - Understanding portfolio risk sources:

Risk Type	Description
Market Risk	Systematic risk from overall market movements
Size Risk	Exposure to small vs. large-cap stocks
Value Risk	Exposure to value vs. growth factors
Momentum Risk	Exposure to recent price trends
Quality Risk	Exposure to fundamental quality metrics
Sector Risk	Concentration risk from sector bets

Stress Testing

Historical Scenario Analysis - How would your portfolio have performed during major market events?

2008 Financial Crisis
COVID-19 Market Crash (March 2020)
Dot-com Bubble Burst (2000-2002)
European Debt Crisis (2011)

Agentic Impact Analysis: Sophisticated scenario analysis powered by multi-agent AI workflow featuring 5-10 specialized agent layers that collaborate to evaluate portfolio impact across different market scenarios. Monte Carlo Simulation: Statistical modeling of potential future outcomes based on historical patterns and correlations.

Holdings Tab: Individual Security Analysis

Parallax Scores by Holding - Each position receives individual factor scores (0-10 scale):

Factor	Description
Value Score	Based on valuation metrics (P/E, P/B, EV/EBITDA, etc.)
Quality Score	Financial strength, profitability, and stability
Momentum Score	Price and earnings momentum indicators
Defensive Score	Low volatility and stable earnings characteristics
Size Score	Market cap factor exposure

Position Analysis:

Portfolio weight vs. benchmark weight
Contribution to total return
Risk contribution to portfolio
Liquidity assessment
ESG scores (where applicable)

Factor Exposure Tab: Quantitative Analysis

Understanding Factor Loadings

What Are Factors? Factors are common characteristics that explain security returns. Academic research has identified several persistent factors that drive investment performance. Your Portfolio’s Factor Exposure:

Factor	Positive Loading	Negative Loading
Size Factor	Tilted toward smaller companies	Tilted toward larger companies
Value Factor	Value-oriented portfolio	Growth-oriented portfolio
Momentum Factor	Momentum strategy	Contrarian strategy
Quality Factor	Quality-focused	Speculative holdings

Factor Performance Attribution

3-Month Performance Attribution:
  Market Beta (1.15): +1.8%
  Value Factor (-0.3): -0.7%
  Size Factor (0.1): +0.2%
  Momentum Factor (0.8): +2.1%
  Quality Factor (0.5): +1.2%

Interpretation: Your portfolio benefited from positive momentum and quality exposure but was hurt by slight growth tilt during a value rally.

Optimization Tab: Improvement Recommendations

AI-Powered Insights

Portfolio Health Check:

Concentration risk assessment
Correlation cluster identification
Factor balance evaluation
Cost efficiency analysis

Specific Recommendations:

Reduce Concentration

“Your top 5 holdings represent 68% of portfolio value. Consider reducing positions in AAPL and MSFT.”

Improve Diversification

“Adding international exposure through VEA or emerging markets via VWO could reduce correlation risk.”

Factor Balance

“Your portfolio has strong momentum exposure but lacks defensive characteristics. Consider adding utilities or consumer staples.”

Tax Efficiency

“Selling XYZ at a loss could offset gains in ABC while maintaining similar factor exposure through DEF.”

Mathematical Optimization

Method	Description
Mean-Variance	Suggests portfolio weights that maximize expected return for given risk level
Risk Parity	Rebalances so each position contributes equally to portfolio risk
Black-Litterman	Incorporates your views and confidence levels to adjust optimization

Advanced Analysis Features

Custom Benchmarks

Create personalized benchmarks reflecting your actual investment universe:

Combine multiple indices with custom weights
Include alternative investments
Adjust for currency exposure
Account for expense ratios and fees

Historical Backtesting

“What If” Analysis:

How would proposed changes have performed historically?
Sensitivity analysis for different market conditions
Transaction cost impact modeling
Tax implications of rebalancing

ESG Integration

Environmental, Social, Governance Analysis:

ESG scores for individual holdings
Portfolio-level ESG metrics
Comparison to ESG benchmarks
Impact of ESG considerations on returns and risk

Common Insights and Actions

Finding	Action
High Concentration (Top 3 holdings = 45%)	Gradually reduce positions, diversify across more holdings
Factor Imbalance (Strong momentum, no defensive)	Add defensive sectors or low-volatility ETFs
Underperforming Holdings (Low Parallax scores)	Research upgrade alternatives with better factor characteristics
Geographic Concentration (95% US)	Add international developed and emerging market exposure

AI Chat Assistant for Portfolio Analysis

AI Technology: Parallax uses a mixture of different LLMs optimized for specific tasks—from natural language understanding to quantitative analysis—integrated with our proprietary financial data infrastructure and real-time market data.

After analyzing your portfolio, use the AI Chat Assistant to dig deeper into findings, get personalized advice, and explore optimization strategies through natural conversation.

Sample Queries

Portfolio-Focused:

"Why is my Parallax score only 6.5? What should I fix first?"
"Explain my factor exposure—why is my Value score so low?"
"My quality factor is 2.8. Which holdings are dragging it down?"

Risk and Optimization:

"What's my biggest risk right now based on this analysis?"
"Which holdings should I replace to improve diversification?"
"How can I increase my defensive factor without losing too much return?"

Strategy Development:

"I want to reduce volatility to 15%. What changes do you suggest?"
"Create a plan to fix my sector concentration issues"
"How do I transition this portfolio to be more ESG-friendly?"

Pro Tip: After getting AI recommendations, ask “Create a stock screen to find replacements” or “Build a sample portfolio showing these changes” to move from analysis to action.

Best Practices

Regular Analysis Schedule

Frequency	Focus
Monthly	Track performance and rebalancing needs
Quarterly	Comprehensive analysis including factor exposures
Annual	Strategic review - assess alignment with long-term objectives

Avoiding Common Pitfalls

Over-Optimization: Don’t chase perfection—focus on material improvements
Ignoring Costs: Factor transaction costs and taxes into decisions
Recency Bias: Consider long-term patterns, not just recent performance
Analysis Paralysis: Take action on clear insights rather than endless analysis

Next Steps

After completing your portfolio analysis:

Stock Screener: Find replacement securities for underperformers
AI Portfolio Builder: Create optimized versions of your portfolio
Methodology: Learn complete optimization workflows and systematic approaches

​Conceptual Foundation

​The Portfolio-First Approach

​Getting Started

​Uploading Your Portfolio

​Sample Portfolio Format

​Portfolio Upload Process

​Understanding Your Analysis

​Overview Tab: Portfolio Summary

​Performance Tab: Return Analysis

​Time-Period Analysis

​Performance Attribution

​Risk Tab: Comprehensive Risk Assessment

​Traditional Risk Metrics

​Advanced Risk Decomposition

​Stress Testing

​Holdings Tab: Individual Security Analysis

​Factor Exposure Tab: Quantitative Analysis

​Understanding Factor Loadings

​Factor Performance Attribution

​Optimization Tab: Improvement Recommendations

​AI-Powered Insights

​Mathematical Optimization

​Advanced Analysis Features

​Custom Benchmarks

​Historical Backtesting

​ESG Integration

​Common Insights and Actions

​AI Chat Assistant for Portfolio Analysis

​Sample Queries

​Best Practices

​Regular Analysis Schedule

​Avoiding Common Pitfalls

​Next Steps

Conceptual Foundation

The Portfolio-First Approach

Getting Started

Uploading Your Portfolio

Sample Portfolio Format

Portfolio Upload Process

Understanding Your Analysis

Overview Tab: Portfolio Summary

Performance Tab: Return Analysis

Time-Period Analysis

Performance Attribution

Risk Tab: Comprehensive Risk Assessment

Traditional Risk Metrics

Advanced Risk Decomposition

Stress Testing

Holdings Tab: Individual Security Analysis

Factor Exposure Tab: Quantitative Analysis

Understanding Factor Loadings

Factor Performance Attribution

Optimization Tab: Improvement Recommendations

AI-Powered Insights

Mathematical Optimization

Advanced Analysis Features

Custom Benchmarks

Historical Backtesting

ESG Integration

Common Insights and Actions

AI Chat Assistant for Portfolio Analysis

Sample Queries

Best Practices

Regular Analysis Schedule

Avoiding Common Pitfalls

Next Steps