One request. Full plan.
MavenFin is an API-first retirement-planning engine. A single POST returns a complete deterministic projection — every monthly cash-flow, every account balance, every tax event, every withdrawal — through end of plan. Layer on Monte Carlo for stochastic risk and Roth-conversion optimization for tax efficiency.
Explore
Three doors in. Pick the one that matches what you need today.
Authenticate
Mint a bearer token via OAuth2 password grant — under 30 seconds, browser-side or server-side.
Run a plan
List households, create a plan, fire a projection. One sequence, full retirement forecast back.
Explore the API
11 endpoints, native interactive cards. Try every call inline with your saved token.
60-second quickstart
Below is the shortest path from a fresh browser to a complete retirement projection. Replace
BEARER with the token you mint in step one — or click Authorize in the
top bar to inject it automatically into every Try-It panel on this site.
# 1. Get a token
curl -u app1:4d1b3c8e-07a0-457d-8f70-09b354e8e5a9 \
-d "grant_type=password&username=marbach&password=r3t1r3&scope=read+write" \
https://legacy.mavenfin.tech/isauthorize19/oauth/token
# 2. List households
curl -H "Authorization: Bearer $BEARER" \
https://legacy.mavenfin.tech/isrestapi19/api/v1/households
# 3. Run a yearly projection for household 1, plan 1
curl -H "Authorization: Bearer $BEARER" \
"https://legacy.mavenfin.tech/isrestapi19/api/v1/households/1/plans/1/projection?granularity=yearly"
marbach / r3t1r3, client app1) are pre-filled in the
Authorize dialog.
What's in the box
Deterministic projection
Every plan is a deterministic function of its inputs: persons, accounts, asset-allocation strategies, spending goals, income streams, and tax assumptions. Given the same inputs you get the same rows — month-by-month, year-by-year — out to plan end (typically age 95). No hidden state.
Seeded Monte Carlo
The MC engine takes the deterministic plan and re-rolls returns under user-supplied mean/vol pairs for
equity and bonds. Pass a seed for bit-identical reruns; the response carries the percentile
fan (P10/P25/P50/P75/P90) and the success rate.
Roth-conversion optimizer
Pick a strategy — thresholdRoth, bracketFill, or dynamic — and a
target bracket, and get a year-by-year conversion schedule plus the lifetime tax-savings curve vs. a
no-conversion baseline. The math accounts for IRMAA tiers, capital-gains stacking, and RMD timing.
Social Security claim strategy
PIA, FRA, and lifetime-benefit curves across claim ages 62 through 70 for client and spouse, with WEP/GPO reductions and the family-maximum cap applied. The optimal-strategy block in the response is the joint-lifetime-maximizing pair.