Term vs whole life (BTID) API

Compare term vs whole-life cost over a horizon and compute the 'buy term and invest the difference' (BTID) future value of the annual premium difference at an investment return — the canonical term-vs-permanent comparison. Deterministic. Answers 'term vs whole life', 'buy term and invest the difference', 'is whole life worth it', 'total cost of term vs whole'.

Price$0.01per request

MethodPOST

Route/v1/calc/ins-term-vs-whole

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcinsurancetermwhole-lifebtidcomparisonactuariallife

API URLhttps://x402.hexl.dev/v1/calc/ins-term-vs-whole

Integration docs

Example request

{
  "termAnnualPremium": 500,
  "wholeAnnualPremium": 5000,
  "years": 30,
  "investmentReturn": 0.07
}

Example response

{
  "method": "term vs whole-life cost comparison (BTID)",
  "totalTermCost": 15000,
  "totalWholeCost": 150000,
  "annualDifference": 4500,
  "investedDifferenceFutureValue": 454828.69,
  "btidAdvantage": 454828.69,
  "recommendation": "buy term & invest the difference (illustrative)",
  "assumptions": {
    "investmentReturn": 0.07,
    "years": 30
  }
}

Input schema

{
  "type": "object",
  "required": [
    "termAnnualPremium",
    "wholeAnnualPremium",
    "years"
  ],
  "properties": {
    "termAnnualPremium": {
      "type": "number",
      "examples": [
        500
      ]
    },
    "wholeAnnualPremium": {
      "type": "number",
      "examples": [
        5000
      ]
    },
    "years": {
      "type": "number",
      "examples": [
        30
      ]
    },
    "investmentReturn": {
      "type": "number",
      "examples": [
        0.07
      ],
      "description": "default 0.07"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}