Actuarial & Financial Projection API
A production-ready Actuarial & Financial Projection API for modern fintech and finance teams. Compute NPV, IRR, DCF, FV, PV, amortization schedules, CAGR, ROI, after‑tax returns, options pricing (Black‑Scholes, binomial), and Monte Carlo risk modeling (GBM) with fast, serverless performance. Versioned under /api/v1 with strict input validation and clear JSON envelopes. Ideal for valuation tools,…
Actuarial & Financial Projection API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Time Value of Money | ||
| POST |
/dcf /dcf |
Discounts the provided cashFlows array as-is and appends a terminal value at year `perpetualGrowthYears` (no auto-generated periods). Adds a warning when the terminal growth rate… |
| POST |
/compound /compound |
Builds a contribution and interest schedule over time. |
| POST |
/npv /npv |
Calculates discounted cash flows and aggregated NPV. |
| POST |
/pv /pv |
Discounts a single future value back to present dollars. |
| POST |
/irr /irr |
Uses Newton-Raphson with a bisection fallback to solve IRR. |
| POST |
/fv /fv |
Projects future value with optional periodic contributions. |
| Loans & Debt | ||
| POST |
/mortgage/payment /mortgage/payment |
Returns periodic mortgage payment and totals. |
| POST |
/mortgage/schedule /mortgage/schedule |
Generates a full amortization table with optional prepayments. |
| Investment | ||
| POST |
/roi /roi |
Computes ROI based on starting value, contributions and ending value. |
| POST |
/cagr /cagr |
Calculates CAGR over a specified time horizon. |
| Retirement | ||
| POST |
/retirement/projection /retirement/projection |
Forecasts balances from current age through life expectancy. |
| POST |
/retirement/survival /retirement/survival |
Monte Carlo probability that assets fund spending needs. |
| Risk Modeling | ||
| POST |
/monte-carlo/fire /monte-carlo/fire |
Simulates the probability and timeline of reaching a FIRE target. |
| POST |
/monte-carlo/portfolio /monte-carlo/portfolio |
Simulates terminal portfolio values across thousands of trials. |
| Options Pricing | ||
| POST |
/options/black-scholes /options/black-scholes |
Prices European options with Greeks via Black-Scholes. |
| POST |
/options/binomial /options/binomial |
CRR binomial tree pricer for European options. |
| Tax Modeling | ||
| POST |
/after-tax-return /after-tax-return |
Projects after-tax value, taxes paid, and effective rate. |
Actuarial & Financial Projection API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 5 / minute |
|
| PRO | $19 / month | 10 / minute |
|
| ULTRA | $49 / month | 30 / minute |
|
| MEGA | $199 / month | 200 / minute |
|