Morivex

Documentation

Understand how Morivex calculates life insurance needs, or integrate our optimization engine into your own application via the REST API.

Quickstart

Enter your financial profile and get a coverage recommendation in under 5 minutes.

Read more

DIME Method

Debt + Income replacement + Mortgage payoff + Education costs. The standard needs-based calculator.

Read more

Human Life Value

Present value of future after-tax earnings, mortality-weighted using SOA actuarial tables.

Read more

Monte Carlo Simulation

10,000-iteration survival simulation using SOA mortality tables for coverage adequacy probability.

Read more

Carrier Comparison

Carriers ranked by NAIC complaint ratio, AM Best rating, estimated premium, and policy features.

Read more

Underwriting Prediction

Rule-based classification into Preferred Plus through Substandard risk tiers.

Read more

API Endpoints

POST/v1/calculate
POST/v1/optimize
GET/v1/mortality/:age/:sex
GET/v1/carriers/:state
POST/v1/underwriting
POST/v1/signup
POST/v1/login
POST/v1/checkout

Authentication

All API requests require an API key passed via the X-API-Key header.

curl https://morivex-api.smarttechinvest.com/v1/calculate \
  -H "X-API-Key: mvx_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"age":35,"income":85000,"dependents":2}'

DIME Method

The DIME method calculates coverage as the sum of four components:

Coverage = Debt + Income_Replacement + Mortgage_Payoff + Education_Costs

Income replacement uses your specified number of years. Education costs are inflation-adjusted at 5% annually using NCES IPEDS published tuition data. This is the framework used by certified financial planners and divorce financial analysts.

Human Life Value

The HLV method computes the present value of your future after-tax earnings stream, weighted by SOA mortality-based survival probabilities at each age:

HLV = sum_t [ Income(t) x (1 - tax_rate) x survival_prob(t) x discount_factor(t) ]

This produces a fundamentally different number than DIME because it accounts for income growth, mortality risk at each age, and the time value of money. The recommended coverage is the maximum of DIME and HLV.

Monte Carlo Survival Simulation

Rather than a single point estimate, Morivex runs 10,000 simulated lifetimes using SOA mortality tables calibrated to your age, sex, and smoker status. Each simulation models the probability of a claim during the policy term and the resulting financial impact on your family.

  • P10 / P25 / P50 / P75 / P90 -- coverage adequacy at each confidence level
  • Shortfall risk -- probability that your coverage falls short of actual need
  • Claim probability -- likelihood of a death benefit payout during the policy term

Carrier Comparison Scoring

Carriers are ranked by a weighted composite score:

  • Estimated premium (40%) -- actuarial premium based on coverage, age, sex, risk class
  • AM Best financial strength (25%) -- carrier ability to pay claims
  • NAIC complaint ratio (20%) -- customer satisfaction metric
  • Policy features (15%) -- conversion options, accelerated death benefit, waiver of premium

Underwriting Risk Prediction

Based on your age, BMI, smoking status, family history, and health conditions, we predict your likely underwriting classification:

Preferred Plus

Preferred

Standard Plus

Standard

Substandard

Your risk class directly affects your premium. A Preferred Plus classification can mean premiums 40-60% lower than Standard for the same coverage amount.