Advisory API Systems LLC
Methodology Disclosure
Effective Date: Upon First API Use
Version: 1.1
Last Updated: December 2025
1. INTRODUCTION
1.1 Purpose of This Disclosure
This Methodology Disclosure provides an overview of the theoretical foundations, analytical approaches, and key assumptions underlying the Advisory API Systems Portfolio Optimization API. This disclosure is intended to help API Users understand how the API generates portfolio recommendations and the factors considered in the optimization process.
1.2 Scope
This document describes the general methodology at a conceptual level. Specific algorithmic implementations, proprietary formulas, and technical parameters constitute confidential trade secrets and are not disclosed.
1.3 Advisory Context
Advisory API Systems provides investment advice to two categories of clients: (a) other registered investment advisers (“RIA Clients”) in a business-to-business capacity, and (b) individual members of the public (“Individual Clients”) in a business-to-consumer capacity. RIA Clients exercise independent professional judgment in determining whether and how to implement API outputs for their End Users. This disclosure is provided to inform Users’ evaluation of the methodology. See the Investment Advice Disclaimer for important risk disclosures.
2. THEORETICAL FOUNDATIONS
2.1 Modern Portfolio Theory
The API builds upon the foundational principles of Modern Portfolio Theory (MPT), developed by Harry Markowitz (Nobel Prize, 1990), which established that:
- Diversification reduces portfolio risk without necessarily reducing expected return
- Optimal portfolios lie on an “efficient frontier” representing the best risk-return tradeoffs
- Portfolio risk depends on the correlations between assets, not just individual asset volatility
2.2 Continuous-Time Portfolio Optimization
The API extends classical MPT using continuous-time portfolio optimization techniques pioneered by Robert Merton (Nobel Prize, 1997). The Merton framework addresses:
- Intertemporal Optimization: How investment decisions today affect future wealth and consumption opportunities
- Human Capital: The value of future labor income as an implicit “bond-like” asset
- Background Risk: How non-tradable assets (homes, pensions, Social Security) affect optimal portfolio allocation
2.3 Utility Theory and Risk Preferences
Portfolio optimization requires a measure of investor preferences. The API employs:
Constant Relative Risk Aversion (CRRA) Utility
CRRA utility is a widely-used framework where risk aversion is independent of wealth level. An investor with CRRA utility evaluates uncertain outcomes using a utility function of the form:
U(W) = W^(1-γ) / (1-γ) for γ ≠ 1
U(W) = ln(W) for γ = 1
Where:
- W = Wealth
- γ (gamma) = Coefficient of relative risk aversion
Higher gamma values indicate greater risk aversion. Common academic estimates suggest gamma values between 2 and 5 for typical investors.
3. KEY METHODOLOGICAL FEATURES
3.1 Household-Level Optimization
Unlike traditional portfolio tools that focus on individual accounts, the API performs household-level optimization that:
- Treats married couples or domestic partners as a single economic unit
- Considers aggregate household assets across all accounts and owners
- Optimizes based on combined household income, expenses, and goals
- Accounts for community property and separate property ownership rules
- Reflects the economic reality that households make joint financial decisions
3.2 Background Asset Integration
A distinguishing feature of the API is its comprehensive treatment of background assets—assets that affect optimal portfolio allocation but may not be readily tradable:
Social Security Benefits
- Projected benefit amounts based on earnings history and claiming age
- Present value calculated using actuarial life tables and discount rates
- Treated as a bond-like asset in portfolio optimization
Pensions and Annuities
- Defined benefit pensions valued based on promised payments
- Annuity income streams discounted to present value
- Survivorship benefits considered for joint optimization
Medicare and Health Benefits
- Expected value of Medicare benefits integrated into wealth calculations
- Supplemental health insurance effects considered
- Medicare Savings Programs (MSPs) evaluated against both federal income
limits and resource limits per 42 C.F.R. § 435.840: Qualified Medicare
Beneficiary (QMB; pays Part A and Part B premiums, deductibles, and
coinsurance), Specified Low-Income Medicare Beneficiary (SLMB; Part B
premium only), Qualifying Individual (QI; Part B premium only), and
Qualified Disabled and Working Individual (QDWI; Part A premium only,
for disabled individuals who returned to work and lost premium-free
Part A per 42 U.S.C. § 1395i-2A). Several states (CA, AZ, CT, DC, ME,
MA, NY, OR, VT) have eliminated or modified MSP resource testing; the
API applies the federal default for conservatism.
Means-Tested Cash Benefits (SSI)
- Supplemental Security Income per 42 U.S.C. §§ 1381-1385f (Title XVI)
integrated as a separate background-wealth category
- Eligibility evaluated on the categorical (aged 65+, blind, or
disabled), resource ($2,000 individual / $3,000 couple), and income
tests
- Annual benefit computed as the federal Benefit Rate (FBR) plus the
California State Supplementary Payment (SSP) per CA W&I Code § 12000
et seq., reduced dollar-for-dollar by counted income after the
$20/month general and $65/month + ½-remainder earned-income
disregards
- Present value computed as a real life annuity using mortality tables
and the real risk-free rate (30-Year TIPS yield)
- Means test uses retirement-period income for the aged pathway and
current income for the disability/blind pathway, since benefits begin
at different points
- SSI is non-taxable per 42 U.S.C. § 1382a and is excluded from
tax-rate inputs
Real Estate
- Primary residence and investment properties incorporated
- Housing treated as a consumption asset and investment asset
- Mortgage debt netted against housing value
Human Capital
- Present value of expected future labor income
- Discounted using appropriate risk-adjusted rates
- Declining value as retirement approaches
3.3 Risk Tolerance Measurement
The API determines risk tolerance through revealed preference methodology rather than subjective questionnaires:
Willingness-to-Pay Elicitation
- Users are presented with hypothetical insurance premium scenarios
- Responses reveal implicit risk preferences
- More economically grounded than behavioral questionnaires
- Reduces common biases in self-reported risk tolerance
The methodology converts elicited preferences into a CRRA gamma parameter that governs portfolio optimization.
3.4 Tax-Aware Optimization
The API incorporates comprehensive tax considerations:
Federal Income Tax
- Current year and projected future marginal tax brackets
- Capital gains tax rates (short-term and long-term)
- Qualified dividend treatment
- Net investment income tax (NIIT)
State Income Tax
- State-specific tax brackets and rates
- States with no income tax
- Community property state considerations
Tax-Advantaged Accounts
- Differential treatment of traditional vs. Roth accounts
- Asset location optimization (which assets in which accounts)
- Tax-efficient withdrawal strategies
Social Security Taxation
- Provisional income calculations
- Phased taxation of benefits
3.5 Asset Class Universe
Portfolio recommendations are expressed in terms of broad asset classes, which may be implemented through investment vehicles like ETFs:
Equity Asset Classes:
- U.S. Large Cap Stocks
- U.S. Small Cap Stocks
- International Developed Market Stocks
- Emerging Market Stocks
Fixed Income Asset Classes:
- U.S. Treasury Bonds
- U.S. Corporate Bonds
- International Bonds
- Treasury Inflation-Protected Securities (TIPS)
Alternative Asset Classes:
- Real Estate Investment Trusts (REITs)
- Commodities
- Precious Metals
- Other diversifying assets
4. OPTIMIZATION PROCESS
4.1 Overview
The API optimization process can be summarized as:
- Data Collection: Receive household financial data via API request
- Background Asset Valuation: Calculate present values of non-tradable assets
- Risk Parameter Determination: Convert elicited preferences to CRRA gamma
- Optimization: Solve for optimal portfolio weights given constraints
- Output Generation: Return recommended allocations and supporting analytics
4.2 Optimization Objective
The optimization seeks to maximize expected utility of lifetime consumption, considering:
- Current and future investment returns
- Labor income and retirement timing
- Social Security and pension benefits
- Tax implications of different strategies
- Mortality and longevity risk
- Spending goals and legacy objectives
4.3 Constraints Considered
The optimization incorporates realistic constraints:
- No negative portfolio weights (unless leverage explicitly permitted)
- Account-specific investment restrictions
- Liquidity requirements
- Minimum allocation thresholds
- Maximum position limits
4.4 Rebalancing Assumptions
The model assumes periodic rebalancing to maintain target allocations. The optimal rebalancing frequency balances:
- Deviation from target allocation
- Transaction costs
- Tax consequences of rebalancing trades
The API requires the following categories of inputs:
Household Composition:
- Number of household members
- Dates of birth / ages
- State of residence
- Filing status
Income and Employment:
- Current income
- Expected retirement age
- Social Security earnings history
- Pension details
Assets and Accounts:
- Account types and balances
- Current investment allocations
- Real estate holdings
- Other significant assets
Liabilities:
- Mortgage balances and terms
- Other debt obligations
Risk Preferences:
- Willingness-to-pay responses or direct gamma input
5.2 Data Quality
The quality of API outputs depends directly on input quality. Users should ensure:
- Data accuracy and completeness
- Current valuations (not stale data)
- Consistent units and formats
- Reasonable assumptions for unknown values
6. OUTPUTS AND INTERPRETATION
6.1 Primary Outputs
The API returns:
Recommended Asset Allocation:
- Target percentage weights for each asset class
- Household-level and account-level views
- Specific ETF allocations with dollar amounts
6.2 Interpretation Guidelines
API outputs constitute investment advice provided to User. Outputs should be interpreted as:
- Professional input for User’s evaluation, requiring independent judgment
- Optimal allocations under model assumptions, which may not hold for all End Users
- Subject to revision based on factors not captured by the model
- One input among many in User’s investment advisory process
6.3 Limitations of Outputs
Outputs do not account for:
- Behavioral factors and emotional responses to volatility
- Near-term liquidity events not specified in inputs
- Concentrated stock positions with significant tax basis
- Specific security selection within asset classes
- Market timing or tactical allocation
- Qualitative factors known to the User
7. MODEL ASSUMPTIONS AND LIMITATIONS
7.1 Capital Market Assumptions
The model incorporates assumptions about expected returns, volatilities, and correlations. These assumptions:
- Are derived from historical data and forward-looking estimates
- May not reflect future market conditions
- Are periodically updated but may lag significant market changes
7.2 Economic Assumptions
Key economic assumptions include:
- Inflation rates
- Interest rate term structure
- Social Security cost-of-living adjustments
- Healthcare cost growth rates
7.3 Behavioral Assumptions
The model assumes rational, utility-maximizing behavior. It does not account for:
- Loss aversion beyond CRRA preferences
- Mental accounting
- Herding behavior
- Overconfidence or other cognitive biases
7.4 Known Limitations
Users should be aware of the following limitations:
- Point-in-Time Analysis: Recommendations are based on current data and assumptions
- Model Risk: Mathematical models may not capture all relevant factors
- Parameter Uncertainty: Input parameters are estimates, not certainties
- Policy Risk: Government policies (tax, Social Security) may change
- Black Swan Events: Extreme events outside historical experience cannot be predicted
8. VALIDATION AND TESTING
8.1 Model Validation
Advisory API Systems employs rigorous model validation procedures:
- Sensitivity analysis of key parameters
- Comparison with academic benchmarks
- Periodic review of methodological choices
8.2 Ongoing Monitoring
Models are continuously monitored for:
- Calculation accuracy
- Parameter stability
- Consistency with theoretical expectations
- Performance relative to benchmarks
8.3 Updates
Model methodologies are updated periodically to reflect:
- New academic research
- Changes in tax law
- Evolving best practices
- User feedback
9. ACADEMIC FOUNDATIONS
9.1 Key References
The API methodology draws upon extensive academic literature, including:
Portfolio Theory:
- Markowitz, H. (1952). “Portfolio Selection.” Journal of Finance.
- Merton, R. (1969). “Lifetime Portfolio Selection under Uncertainty.”
- Merton, R. (1971). “Optimum Consumption and Portfolio Rules in a Continuous-Time Model.”
Human Capital and Background Risk:
- Bodie, Z., Merton, R., & Samuelson, W. (1992). “Labor Supply Flexibility and Portfolio Choice in a Life Cycle Model.”
- Cocco, J., Gomes, F., & Maenhout, P. (2005). “Consumption and Portfolio Choice over the Life Cycle.”
Risk Preferences:
- Arrow, K. (1971). “Essays in the Theory of Risk-Bearing.”
- Pratt, J. (1964). “Risk Aversion in the Small and in the Large.”
Tax-Efficient Investing:
- Dammon, R., Spatt, C., & Zhang, H. (2004). “Optimal Asset Location and Allocation with Taxable and Tax-Deferred Investing.”
9.2 Ongoing Research
Advisory API Systems monitors ongoing academic research and incorporates relevant findings into methodology updates.
10. PROPRIETARY ELEMENTS
10.1 Trade Secrets
While this disclosure describes the general methodology, the following elements are proprietary and confidential:
- Specific algorithmic implementations
- Parameter estimation techniques
- ETF selection and weighting methodologies
- Performance optimization techniques
- Source code
10.2 No Disclosure Obligation
Advisory API Systems is not obligated to disclose proprietary methodological details beyond this general overview.
Advisory API Systems LLC
Email: [email protected]
Phone: (310) 839-0358
This Methodology Disclosure is incorporated by reference into the User Agreement. By using the API, you acknowledge that you have read and understood this disclosure.