Debt consolidation calculator API

Amortizes each existing debt (n = -ln(1-P*r/M)/ln(1+r)) to total current interest, then compares a single consolidation loan and recommends whether consolidating lowers cost. Answers 'Should I consolidate my debts?','How much interest does consolidating save or cost?'.

Price$0.01per request

MethodPOST

Route/v1/calc/loan-consolidation

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

loanconsolidationdebtrefinanceinterestcomparisoncalculator

API URLhttps://x402.hexl.dev/v1/calc/loan-consolidation

Integration docs

Example request

{
  "debts": [
    {
      "balance": 8000,
      "annualRatePct": 22,
      "monthlyPayment": 300
    },
    {
      "balance": 5000,
      "annualRatePct": 18,
      "monthlyPayment": 200
    }
  ],
  "consolidationRatePct": 11,
  "consolidationTermMonths": 60
}

Example response

{
  "totalBalance": 13000,
  "currentMonthlyTotal": 500,
  "currentTotalInterest": 4396.72,
  "consolidatedPayment": 282.65,
  "consolidatedTotalInterest": 3959.09,
  "interestDelta": -437.63,
  "monthlyPaymentDelta": -217.35,
  "worthConsolidating": true,
  "recommendation": "Consolidating lowers total interest cost.",
  "breakdown": {
    "numDebts": 2,
    "consolidationRatePct": 11,
    "consolidationTermMonths": 60,
    "fees": 0
  }
}

Input schema

{
  "type": "object",
  "required": [
    "debts",
    "consolidationRatePct",
    "consolidationTermMonths"
  ],
  "properties": {
    "debts": {
      "type": "array",
      "description": "Existing debts to consolidate.",
      "items": {
        "type": "object",
        "required": [
          "balance",
          "annualRatePct",
          "monthlyPayment"
        ],
        "properties": {
          "balance": {
            "type": "number",
            "examples": [
              8000
            ]
          },
          "annualRatePct": {
            "type": "number",
            "examples": [
              22
            ]
          },
          "monthlyPayment": {
            "type": "number",
            "examples": [
              300
            ]
          }
        }
      },
      "examples": [
        [
          {
            "balance": 8000,
            "annualRatePct": 22,
            "monthlyPayment": 300
          },
          {
            "balance": 5000,
            "annualRatePct": 18,
            "monthlyPayment": 200
          }
        ]
      ]
    },
    "consolidationRatePct": {
      "type": "number",
      "description": "Consolidation loan annual rate in percent.",
      "examples": [
        11
      ]
    },
    "consolidationTermMonths": {
      "type": "number",
      "description": "Consolidation loan term in months.",
      "examples": [
        60
      ]
    },
    "fees": {
      "type": "number",
      "description": "Origination fees added to the consolidation principal (default 0).",
      "examples": [
        0
      ]
    }
  }
}

Output schema

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