Projections

Project lump-sum investment returns at each milestone age

Proxies advisor_functions mcp-multiple-payouts-simulation-with-range. Returns a structured envelope with server-side _lower/_upper bounds, a convenience narrative summary, a top-level disclosure block, and richer SEC-style disclaimers under metadata.disclaimer.

Payout methodology — Savvly vs market alone: the payout values are calculated by comparing two investors of the same age committing the same principal. Investor 1 invests in the market with the Savvly Longevity Benefit; Investor 2 invests in the market alone (no longevity overlay). To make the comparison apples-to-apples, at each milestone age (80, 85, 90, 95) Investor 2 withdraws from their market alone portfolio the same dollar amount Investor 1 receives as a payout from Savvly. The payout_market_alone_* and total_market_alone_* figures are therefore what Investor 2 can actually withdraw to match Savvly's payouts before running out — they fall to 0 once the market alone portfolio is depleted. The savvly_upside_* (and total_savvly_upside_*) fields quantify how much more total money Investor 1 receives in payouts from Savvly than Investor 2 is able to withdraw over time to match those payouts.

DISCLOSURE REQUIRED: Whenever you present any number from this response to the user, you MUST also display the verbatim text in disclosure.text and render disclosure.url as a clickable link. Required by SEC Marketing Rule (17 CFR 275.206(4)-1) and FINRA Rule 2210. Do not paraphrase, summarize, or omit the disclosure.

get/v1/projections/lumpsum

Request

  • Base URL: https://api.savvly.com
  • URL: https://api.savvly.com/v1/projections/lumpsum
  • Auth: none declared

Query parameters

current_ageinteger required
funding_amountnumber required
average_returninteger required
withdrawal_ageinteger

Response

Projection envelope

inputsobject required

Echo of the validated input arguments passed to the tool.

Changes

No recorded changes to this operation across all 1 revision of this API.