TerraVue

{
  "type": "object",
  "title": "affordable_priceArguments",
  "required": [
    "annual_income"
  ],
  "properties": {
    "address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Address",
      "default": null,
      "description": "Full US street address, or a bare 5-digit ZIP. Pass it whenever it is known: it grounds property tax, insurance and the appreciation forecast in that ZIP's real figures instead of national defaults."
    },
    "fixed_rate": {
      "type": "number",
      "title": "Fixed Rate",
      "default": 6.75,
      "description": "Mortgage interest rate as an annual PERCENT: 6.75 means 6.75%. Not a decimal (not 0.0675)."
    },
    "hoa_monthly": {
      "type": "number",
      "title": "Hoa Monthly",
      "default": 0,
      "description": "HOA or condo fee in US dollars per month. 0 for most single-family homes."
    },
    "annual_income": {
      "type": "number",
      "title": "Annual Income",
      "description": "Gross household income before tax, in whole US dollars per year, e.g. 140000."
    },
    "monthly_debts": {
      "type": "number",
      "title": "Monthly Debts",
      "default": 0,
      "description": "Recurring DEBT obligations a lender counts, in dollars per month: car payment, student loan, minimum credit-card payment. This feeds DTI. Do NOT put groceries, utilities or childcare here."
    },
    "insurance_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Insurance Rate",
      "default": null,
      "description": "Annual homeowners insurance as a PERCENT of home value: 0.45 means 0.45%/yr. Leave unset to use the regional default."
    },
    "liquid_savings": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Liquid Savings",
      "default": null,
      "description": "Cash available for down payment and closing costs, in US dollars. Supplying it adds the post-closing cash cushion and the cash-limited price check."
    },
    "back_end_dti_pct": {
      "type": "number",
      "title": "Back End Dti Pct",
      "default": 36,
      "description": "Back-end DTI cap as a PERCENT: housing plus other debts, divided by gross income. The lender standard is 36. Only change it if the user names a different limit."
    },
    "down_payment_pct": {
      "type": "number",
      "title": "Down Payment Pct",
      "default": 20,
      "description": "Down payment as a PERCENT of price: 20 means 20%. Not a fraction (not 0.20)."
    },
    "front_end_dti_pct": {
      "type": "number",
      "title": "Front End Dti Pct",
      "default": 28,
      "description": "Front-end DTI cap as a PERCENT: housing cost divided by gross income. The lender standard is 28. Only change it if the user names a different limit."
    },
    "property_tax_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Property Tax Rate",
      "default": null,
      "description": "Annual property tax as a PERCENT of home value: 0.55 means 0.55%/yr. Leave unset to use the ZIP's real rate when `address` is given."
    }
  }
}

{
  "type": "object",
  "title": "buy_vs_rentArguments",
  "required": [
    "home_price",
    "monthly_rent"
  ],
  "properties": {
    "address": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Address",
      "default": null,
      "description": "Full US street address, or a bare 5-digit ZIP. Pass it whenever it is known: it grounds property tax, insurance and the appreciation forecast in that ZIP's real figures instead of national defaults."
    },
    "fixed_rate": {
      "type": "number",
      "title": "Fixed Rate",
      "default": 6.75,
      "description": "Mortgage interest rate as an annual PERCENT: 6.75 means 6.75%. Not a decimal (not 0.0675)."
    },
    "home_price": {
      "type": "number",
      "title": "Home Price",
      "description": "Purchase price in whole US dollars, e.g. 650000 (not 650 or 650k)."
    },
    "hoa_monthly": {
      "type": "number",
      "title": "Hoa Monthly",
      "default": 0,
      "description": "HOA or condo fee in US dollars per month. 0 for most single-family homes."
    },
    "monthly_rent": {
      "type": "number",
      "title": "Monthly Rent",
      "description": "What this person would pay per month, in US dollars, to rent THE SAME HOME to live in. This is an owner-occupant comparison — it is NOT rental income they would collect as a landlord."
    },
    "analysis_years": {
      "type": "integer",
      "title": "Analysis Years",
      "default": 30,
      "description": "Hold period in years. Use the horizon the person actually stated — if they say 'about five years', pass 5. Only default to 30 when no horizon was given."
    },
    "down_payment_pct": {
      "type": "number",
      "title": "Down Payment Pct",
      "default": 20,
      "description": "Down payment as a PERCENT of price: 20 means 20%. Not a fraction (not 0.20)."
    },
    "property_tax_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Property Tax Rate",
      "default": null,
      "description": "Annual property tax as a PERCENT of home value: 0.55 means 0.55%/yr. Leave unset to use the ZIP's real rate when `address` is given."
    },
    "home_appreciation_rate": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Home Appreciation Rate",
      "default": null,
      "description": "Annual home appreciation as a PERCENT: 3.5 means 3.5%/yr. Prefer leaving this unset and passing `address` instead, so the ZIP's FHFA-derived forecast is used rather than a guess."
    },
    "investment_return_rate": {
      "type": "number",
      "title": "Investment Return Rate",
      "default": 9.5,
      "description": "Annual return the renter earns on invested cash, as a PERCENT: 9.5 means 9.5%/yr, roughly long-run equities. This assumption drives the result more than any other — drop it to about 4.5 if the alternative is savings rather than the market, or if the person sounds risk-averse, and present both runs."
    }
  }
}