Cash-on-cash return API

Cash-on-cash = annual pre-tax cash flow (rent net of vacancy, opex, debt service) / total cash invested, with a rating bucket. The leveraged-investor return metric. Answers 'cash-on-cash return on this deal', 'annual cash flow after the mortgage', 'is 10% cash-on-cash good'.

Price$0.01per request

MethodPOST

Route/v1/calc/re-cash-on-cash

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

real-estatecash-on-cashreturncash-flowrentalinvestmentfinancecalc

API URLhttps://x402.hexl.dev/v1/calc/re-cash-on-cash

Integration docs

Example request

{
  "monthlyRent": 2500,
  "vacancyPct": 5,
  "monthlyOpEx": 800,
  "monthlyDebtService": 1264.14,
  "cashInvested": 80000
}

Example response

{
  "monthlyCashFlow": 310.86,
  "annualCashFlow": 3730.32,
  "cashInvested": 80000,
  "cashOnCashPct": 4.66,
  "rating": "weak (<6%)"
}

Input schema

{
  "type": "object",
  "required": [
    "monthlyRent",
    "cashInvested"
  ],
  "properties": {
    "monthlyRent": {
      "type": "number",
      "examples": [
        2500
      ]
    },
    "vacancyPct": {
      "type": "number",
      "default": 0
    },
    "monthlyOpEx": {
      "type": "number",
      "examples": [
        800
      ]
    },
    "monthlyDebtService": {
      "type": "number",
      "examples": [
        1264.14
      ]
    },
    "cashInvested": {
      "type": "number",
      "description": "down payment + closing + rehab",
      "examples": [
        80000
      ]
    }
  }
}

Output schema

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