Annuity payout (PMT) API

Compute the level periodic payout from a principal using the canonical annuity payment formula PMT = PV·i/(1−(1+i)^−n) (immediate or annuity-due), with total paid out and total interest. Deterministic time-value math LLMs get wrong. Answers 'monthly annuity payout from a lump sum', 'how much income does $500k buy', 'annuity payment formula', 'amortized withdrawal amount'.

Price$0.01per request

MethodPOST

Route/v1/calc/ins-annuity-payout

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcinsuranceannuitypayoutpmttime-valueretirementactuarial

API URLhttps://x402.hexl.dev/v1/calc/ins-annuity-payout

Integration docs

Example request

{
  "principal": 500000,
  "annualRate": 0.04,
  "years": 20,
  "paymentsPerYear": 12
}

Example response

{
  "method": "present-value annuity payout (PMT = PV·i/(1−(1+i)^−n))",
  "paymentPerPeriod": 3029.9,
  "paymentsPerYear": 12,
  "totalPayments": 240,
  "totalPaidOut": 727176.4,
  "totalInterest": 227176.4,
  "inputs": {
    "principal": 500000,
    "annualRate": 0.04,
    "years": 20,
    "due": false
  }
}

Input schema

{
  "type": "object",
  "required": [
    "principal",
    "years"
  ],
  "properties": {
    "principal": {
      "type": "number",
      "examples": [
        500000
      ]
    },
    "annualRate": {
      "type": "number",
      "examples": [
        0.04
      ],
      "description": "decimal, default 0"
    },
    "years": {
      "type": "number",
      "examples": [
        20
      ]
    },
    "paymentsPerYear": {
      "type": "number",
      "examples": [
        12
      ],
      "description": "default 12"
    },
    "due": {
      "type": "boolean",
      "examples": [
        false
      ],
      "description": "annuity-due if true"
    }
  }
}

Output schema

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