Skip to content

Investment · Calculation

Hard money and bridge draw ledger

Models purchase advance, progressive rehab funding, LTV/LTC/LTARV limits, a supplied loan cap, interest, default rate, points, extensions, fees and payoff. Over-limit scenarios retain the engine funding state. Amounts are USD and month zero is closing.

Example result · state: available See output

Cost per success
20 calculation credits
Production plans
Standard, Business, Scale, Enterprise
Plan allowances
Free sandbox
Not available

Integration example

Make a request

Use a production key scoped to investor-hard-money.

Keep the key on your server. A successful call uses 20 calculation credits.

Production request

Set HT_PRODUCTION_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.

import { randomUUID } from "node:crypto";

const key = process.env.HT_PRODUCTION_KEY;
if (!key) throw new Error("Set HT_PRODUCTION_KEY on your server.");
const endpoint = "https://calc.hasstechapi.com/v2/calc/investor-hard-money";
const input = {
  "purchasePrice": 200000,
  "rehabBudget": 30000,
  "afterRepairValue": 350000,
  "acquisitionAdvance": 140000,
  "rehabDraws": [
    {
      "month": 2,
      "amount": 15000
    },
    {
      "month": 3,
      "amount": 15000
    }
  ],
  "annualRatePct": 12,
  "termMonths": 12,
  "payoffMonth": 6,
  "ltvPct": 70,
  "ltcPct": 90,
  "ltarvPct": 70,
  "ltvBasis": "acquisition-advance",
  "pointsPct": 2,
  "pointsBasis": "funded",
  "minimumInterestMonths": 3,
  "extensionFeePerMonth": 500,
  "exitFeePct": 1,
  "otherFees": []
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);

const response = await fetch(endpoint, {
  method: "POST",
  redirect: "error",
  headers: {
    "Authorization": "Bearer " + key,
    "Content-Type": "application/json",
    "Idempotency-Key": requestId
  },
  body: JSON.stringify(input)
});
if (!response.ok) {
  const problem = await response.json().catch(() => null);
  const code = problem?.error?.code || response.statusText;
  const delay = response.headers.get("retry-after");
  if (delay) console.error("Retry-After (seconds):", delay);
  console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
  if (Array.isArray(problem?.error?.details)) {
    for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
  }
  process.exitCode = 1;
} else {
  console.log(JSON.stringify(await response.json(), null, 2));
}
cURL (shell)

Set HT_PRODUCTION_KEY on your server. Run in a POSIX shell with cURL 7.76+ and Python 3.7+ to create a request ID.

(
  set -eu
  : "${HT_PRODUCTION_KEY:?Set HT_PRODUCTION_KEY on your server}"
  request_id="${HT_REQUEST_ID:-}"
  if [ -z "$request_id" ]; then
    request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
  fi
  printf 'Usage lookup ID: %s\n' "$request_id" >&2
  # On INVALID_INPUT, read error.details in the JSON response body.
  curl --disable --silent --show-error --fail-with-body --include \
    --request POST 'https://calc.hasstechapi.com/v2/calc/investor-hard-money' \
    --header "Authorization: Bearer $HT_PRODUCTION_KEY" \
    --header 'Content-Type: application/json' \
    --header "Idempotency-Key: $request_id" \
    --data-binary @- <<'HT_INPUT'
{
  "purchasePrice": 200000,
  "rehabBudget": 30000,
  "afterRepairValue": 350000,
  "acquisitionAdvance": 140000,
  "rehabDraws": [
    {
      "month": 2,
      "amount": 15000
    },
    {
      "month": 3,
      "amount": 15000
    }
  ],
  "annualRatePct": 12,
  "termMonths": 12,
  "payoffMonth": 6,
  "ltvPct": 70,
  "ltcPct": 90,
  "ltarvPct": 70,
  "ltvBasis": "acquisition-advance",
  "pointsPct": 2,
  "pointsBasis": "funded",
  "minimumInterestMonths": 3,
  "extensionFeePerMonth": 500,
  "exitFeePct": 1,
  "otherFees": []
}
HT_INPUT
)
If your request fails
400 INVALID_INPUT

Read error.details when present. Node prints each issue. cURL returns the JSON body. Each path points into your request. An empty path refers to the whole body.

Check the accepted inputs for required fields, units and ranges. Send the corrected JSON as a new request.

401 or 403
Check that the server has the bearer key for the endpoint’s environment and that the key includes investor-hard-money.
429
Read the service error code, check your allowance, and wait for the Retry-After interval when supplied before trying again.
Lost response, 409 or 503
Open Request lookup, select the same environment and enter the printed usage lookup ID. A settled ID has already consumed credits. To retry the same calculation, set HT_REQUEST_ID to the original ID and reuse the same inputs. A settled request does not return its result again. Unset the variable for a new request, which can consume credits.

The usage lookup ID is the Idempotency-Key your server sends. The response’s x-request-id identifies the HTTP exchange for support.

Output

Example result

These values come from running this operation on the example inputs.

state
available
formulaVersion
hard-money-2.0.0
value.requestedLoan
170000
How to interpret this result
  • Models purchase advance, progressive rehab funding, LTV/LTC/LTARV limits, a supplied loan cap, interest, default rate, points, extensions, fees and payoff. Over-limit scenarios retain the engine funding state. Amounts are USD and month zero is closing.
Full example response (JSON)
{
  "status": "available",
  "result": {
    "state": "available",
    "fieldErrors": {},
    "warnings": [],
    "assumptions": [],
    "provenance": [
      {
        "source": "Standard monthly level-payment annuity formula, nominal annual rate / 12",
        "asOf": "2026-08-13"
      },
      {
        "source": "Declared opening-funded-balance progressive-draw convention",
        "asOf": "2026-08-13"
      }
    ],
    "formulaVersion": "hard-money-2.0.0",
    "ruleVersions": [
      "strictest-of-LTV-LTC-LTARV-program-cap",
      "draw-funds-after-monthly-interest",
      "minimum-interest-on-initial-acquisition-advance",
      "points-basis:funded"
    ],
    "auditTrail": [
      "Loan 170000.00 is within the strictest LTV cap 170000.00.",
      "Interest accrued monthly on opening funded balance; draws first accrue in the following month.",
      "Charged interest is max(actual 9450.00, minimum 4200.00).",
      "Fees retain timing: upfront 0.00, interim 0.00, payoff 0.00."
    ],
    "value": {
      "requestedLoan": "170000",
      "maxByLtv": "170000",
      "maxByLtc": "207000",
      "maxByLtarv": "245000",
      "maxByProgram": null,
      "constrainedMaxLoan": "170000",
      "limitingConstraint": "LTV",
      "fundingState": "within-constraints",
      "rehabHoldbackRemaining": "0",
      "ledger": [
        {
          "month": 1,
          "openingBalance": "140000",
          "drawn": "0",
          "annualRatePct": "12",
          "interest": "1400",
          "closingBalance": "140000"
        },
        {
          "month": 2,
          "openingBalance": "140000",
          "drawn": "15000",
          "annualRatePct": "12",
          "interest": "1400",
          "closingBalance": "155000"
        },
        {
          "month": 3,
          "openingBalance": "155000",
          "drawn": "15000",
          "annualRatePct": "12",
          "interest": "1550",
          "closingBalance": "170000"
        },
        {
          "month": 4,
          "openingBalance": "170000",
          "drawn": "0",
          "annualRatePct": "12",
          "interest": "1700",
          "closingBalance": "170000"
        },
        {
          "month": 5,
          "openingBalance": "170000",
          "drawn": "0",
          "annualRatePct": "12",
          "interest": "1700",
          "closingBalance": "170000"
        },
        {
          "month": 6,
          "openingBalance": "170000",
          "drawn": "0",
          "annualRatePct": "12",
          "interest": "1700",
          "closingBalance": "170000"
        }
      ],
      "totalDrawn": "30000",
      "actualInterest": "9450",
      "minimumInterestCharge": "4200",
      "chargedInterest": "9450",
      "pointsCost": "3400",
      "extensionFees": "0",
      "otherFees": "0",
      "upfrontFees": "0",
      "interimFees": "0",
      "payoffFees": "0",
      "exitFee": "1700",
      "payoffPrincipal": "170000",
      "totalPayoff": "181150",
      "cashRequired": "63400"
    }
  },
  "formulaVersion": "hard-money-2.0.0",
  "units": {
    "money": "USD",
    "months": "whole months",
    "years": "whole years",
    "percentage": "percent points (6 = 6%)",
    "dscr": "income divided by debt service, unitless"
  },
  "assumptions": [
    "Models purchase advance, progressive rehab funding, LTV/LTC/LTARV limits, a supplied loan cap, interest, default rate, points, extensions, fees and payoff. Over-limit scenarios retain the engine funding state. Amounts are USD and month zero is closing."
  ],
  "warnings": [],
  "creditCost": 20
}

Request contract

Accepted inputs

Fields for this example. Expand the schema for all supported combinations and limits.

FieldType, units and limits

purchasePriceRequired
number

Property purchase price in USD, before rehab.

Min 0.01 · Max 1000000000
rehabBudgetRequired
number

Total budget in USD for rehab, including any portion funded by the borrower.

Min 0 · Max 1000000000
afterRepairValueRequired
number

Caller-supplied property value in USD after the planned rehab.

Min 0.01 · Max 1000000000
acquisitionAdvanceRequired
number

USD advanced at acquisition, before later rehab draws.

Min 0 · Max 1000000000
rehabDrawsRequired
arrayMin items 0 · Max items 120
rehabDraws[].monthRequired
integer

One-based loan month when this draw is added to principal after interest accrues on the opening balance.

Min 1 · Max 120
rehabDraws[].amountRequired
number

Amount of this rehab draw in USD.

Min 0 · Max 1000000000
annualRatePctRequired
number

Annual interest rate on funded principal in percent (12 means 12% per year).

Min 0 · Max 100
defaultAnnualRatePctOptional
number

Annual interest rate in percent applied from the modeled default month.

Min 0 · Max 100
defaultMonthOptional
integer

One-based loan month when the modeled default interest rate first applies.

Min 1 · Max 120
termMonthsRequired
integer

Whole months in the contractual loan term before extension fees apply.

Min 1 · Max 120
payoffMonthRequired
integer

One-based loan month at the end of which the model pays off the loan.

Min 1 · Max 120
ltvPctRequired
number

Maximum percent of purchase price under the selected LTV basis (70 means 70%).

Min 0.01 · Max 100
ltcPctRequired
number

Maximum loan as a percent of purchase price plus rehab budget.

Min 0.01 · Max 100
ltarvPctRequired
number

Maximum loan as a percent of the entered after-repair value.

Min 0.01 · Max 100
ltvBasisRequired
stringAllowed: "total-loan", "acquisition-advance"
programMaxLoanOptional
number

Caller-supplied absolute loan ceiling in USD.

Min 0.01 · Max 1000000000
pointsPctRequired
number

Origination points as a percent of requested funded principal or the constrained commitment according to pointsBasis (2 means two points).

Min 0 · Max 100
pointsBasisRequired
stringAllowed: "funded", "committed"
minimumInterestMonthsRequired
integer

Whole months of interest on the original acquisition advance used to set the minimum interest charge.

Min 0 · Max 120
extensionFeePerMonthRequired
number

USD charged for each month payoff extends beyond the contractual term.

Min 0 · Max 1000000000
exitFeePctRequired
number

Payoff fee as a percent of principal outstanding in the payoff month.

Min 0 · Max 100
otherFeesRequired
arrayMin items 0 · Max items 120
otherFees[].monthRequired
integer

Loan month for this fee. Zero is closing, and payoffMonth is the payoff month.

Min 0 · Max 120
otherFees[].amountRequired
number

Amount of this additional fee in USD.

Min 0 · Max 1000000000
Example request body (JSON)
{
  "purchasePrice": 200000,
  "rehabBudget": 30000,
  "afterRepairValue": 350000,
  "acquisitionAdvance": 140000,
  "rehabDraws": [
    {
      "month": 2,
      "amount": 15000
    },
    {
      "month": 3,
      "amount": 15000
    }
  ],
  "annualRatePct": 12,
  "termMonths": 12,
  "payoffMonth": 6,
  "ltvPct": 70,
  "ltcPct": 90,
  "ltarvPct": 70,
  "ltvBasis": "acquisition-advance",
  "pointsPct": 2,
  "pointsBasis": "funded",
  "minimumInterestMonths": 3,
  "extensionFeePerMonth": 500,
  "exitFeePct": 1,
  "otherFees": []
}
Full JSON schema
{
  "type": "object",
  "properties": {
    "purchasePrice": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 1000000000,
      "description": "Property purchase price in USD, before rehab."
    },
    "rehabBudget": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000,
      "description": "Total budget in USD for rehab, including any portion funded by the borrower."
    },
    "afterRepairValue": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 1000000000,
      "description": "Caller-supplied property value in USD after the planned rehab."
    },
    "acquisitionAdvance": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000,
      "description": "USD advanced at acquisition, before later rehab draws."
    },
    "rehabDraws": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "month": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120,
            "description": "One-based loan month when this draw is added to principal after interest accrues on the opening balance."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "description": "Amount of this rehab draw in USD."
          }
        },
        "required": [
          "month",
          "amount"
        ],
        "additionalProperties": false
      },
      "minItems": 0,
      "maxItems": 120
    },
    "annualRatePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Annual interest rate on funded principal in percent (12 means 12% per year)."
    },
    "defaultAnnualRatePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Annual interest rate in percent applied from the modeled default month."
    },
    "defaultMonth": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "One-based loan month when the modeled default interest rate first applies."
    },
    "termMonths": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Whole months in the contractual loan term before extension fees apply."
    },
    "payoffMonth": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "One-based loan month at the end of which the model pays off the loan."
    },
    "ltvPct": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 100,
      "description": "Maximum percent of purchase price under the selected LTV basis (70 means 70%)."
    },
    "ltcPct": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 100,
      "description": "Maximum loan as a percent of purchase price plus rehab budget."
    },
    "ltarvPct": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 100,
      "description": "Maximum loan as a percent of the entered after-repair value."
    },
    "ltvBasis": {
      "enum": [
        "total-loan",
        "acquisition-advance"
      ]
    },
    "programMaxLoan": {
      "type": "number",
      "minimum": 0.01,
      "maximum": 1000000000,
      "description": "Caller-supplied absolute loan ceiling in USD."
    },
    "pointsPct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Origination points as a percent of requested funded principal or the constrained commitment according to pointsBasis (2 means two points)."
    },
    "pointsBasis": {
      "enum": [
        "funded",
        "committed"
      ]
    },
    "minimumInterestMonths": {
      "type": "integer",
      "minimum": 0,
      "maximum": 120,
      "description": "Whole months of interest on the original acquisition advance used to set the minimum interest charge."
    },
    "extensionFeePerMonth": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000000000,
      "description": "USD charged for each month payoff extends beyond the contractual term."
    },
    "exitFeePct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Payoff fee as a percent of principal outstanding in the payoff month."
    },
    "otherFees": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "month": {
            "type": "integer",
            "minimum": 0,
            "maximum": 120,
            "description": "Loan month for this fee. Zero is closing, and payoffMonth is the payoff month."
          },
          "amount": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000000,
            "description": "Amount of this additional fee in USD."
          }
        },
        "required": [
          "month",
          "amount"
        ],
        "additionalProperties": false
      },
      "minItems": 0,
      "maxItems": 120
    }
  },
  "required": [
    "purchasePrice",
    "rehabBudget",
    "afterRepairValue",
    "acquisitionAdvance",
    "rehabDraws",
    "annualRatePct",
    "termMonths",
    "payoffMonth",
    "ltvPct",
    "ltcPct",
    "ltarvPct",
    "ltvBasis",
    "pointsPct",
    "pointsBasis",
    "minimumInterestMonths",
    "extensionFeePerMonth",
    "exitFeePct",
    "otherFees"
  ],
  "additionalProperties": false,
  "description": "Models purchase advance, progressive rehab funding, LTV/LTC/LTARV limits, a supplied loan cap, interest, default rate, points, extensions, fees and payoff. Over-limit scenarios retain the engine funding state. Amounts are USD and month zero is closing."
}

Production endpoint: POST https://calc.hasstechapi.com/v2/calc/investor-hard-money
Formula: hard-money-2.0.0

Related PDF reports