{"uid":"cap_RoHGWRAN6nALzsvSuk2u5","slug":"retirement-readiness-projection-8256b205","name":"Retirement Readiness Projection","description":"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.","url":"https://x402toll.com/v1/reports/retirement-readiness","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"currentAge":{"type":"number","maximum":90,"minimum":16},"currentIncome":{"type":"number","maximum":1000000000,"minimum":0},"retirementAge":{"type":"number","default":65},"currentSavings":{"type":"number","default":0},"expectedReturnPct":{"type":"number","default":7},"withdrawalRatePct":{"type":"number","default":4},"annualContribution":{"type":"number","default":0},"incomeReplacementPct":{"type":"number","default":80}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pVeIuSmKhvLZ2A_-lQ92q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Projects retirement savings growth, calculates the nest egg required by the 4% rule for a target income, and shows the surplus or gap plus extra monthly savings needed to close it.","exampleAgentPrompt":"I'm 34 years old, earn $95,000 a year, have $42,000 saved so far, and contribute $8,000 a year. Assuming 7% returns and I want to retire at 65 replacing 80% of my income — am I on track, and if not, how much more do I need to save each month?","exampleUseCases":null,"resultDescription":"Returns the projected nest egg at retirement age (based on current savings and contributions compounded at the expected return), the required nest egg per the 4% (or custom) withdrawal rule for the target income replacement, the dollar surplus or gap between the two, and the extra monthly contribution needed to fully close any shortfall.","failureModes":["currentAge missing or out of range (16–90) returns validation error","retirementAge less than or equal to currentAge causes invalid horizon error","Negative or zero currentIncome may produce undefined income replacement targets","expectedReturnPct or withdrawalRatePct set to extreme values (e.g. 0 or >30) may produce unrealistic projections","Payment of $1 USDC not completed returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a single-call retirement readiness snapshot — specifically the gap between projected savings and the 4%-rule-derived nest egg, plus the actionable monthly contribution delta. Prefer this over generic compound-interest calculators when you need income-replacement-based targeting and a shortfall-closing prescription in one response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:57.542Z","isFirstParty":false}