Retirement

Retirement-readiness projection: your savings grown to retirement age, the nest egg the 4%-rule requires for your target income, the surplus or gap, and the extra monthly contribution to close it.

Retirement-readiness projection: your savings grown to retirement age, the nest egg the 4%-rule requires for your target income, the surplus or gap, and the extra monthly contribution to close it.

Payment: x402 ($1.00 USDC on eip155:8453). Call unpaid to receive an HTTP 402 with requirements, then retry with the PAYMENT-SIGNATURE header. Method: projected = currentSavings·(1+r)ⁿ + contribution·[((1+r)ⁿ-1)/r]; requiredNestEgg = (income·replacement%) / withdrawal%; gap solved back to an annual/monthly contribution

post/v1/reports/retirement-readiness

Request

  • Base URL: (relative, and it does not resolve against the document’s source URL)
  • URL: /v1/reports/retirement-readiness
  • Auth: none declared

Request body

currentAgenumber required
retirementAgenumber
currentSavingsnumber
annualContributionnumber
expectedReturnPctnumber
currentIncomenumber required
incomeReplacementPctnumber
withdrawalRatePctnumber

Response

Verified result + provenance (formula, sources, reproducible SHA-256 hash).

Changes

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