使用小数形式的利率和房产税率估算房贷月供
查看 美国房产与房贷数据 API 的全部接口 →根据必填查询参数 price、down_payment、hoa_fees、home_insurance、property_tax_rate、rate 和 term 估算住房贷款还款金额;apply_veterans_benefits 为可选布尔参数。首付款 down_payment 填写金额,而不是百分比。年利率和年度房产税率均使用小数形式:rate=0.065 表示年利率 6.5%,property_tax_rate=0.012 表示年度房产税率 1.2%。曾有一次检查使用 6.5 和 1.2,虽然返回 HTTP 200,但计算金额明显偏高,因此不能仅凭请求成功就认定财务输入合理。 已成功核验的情景使用 price=500000、down_payment=100000、hoa_fees=0、home_insurance=100、term=30、apply_veterans_benefits=false,以及上述小数形式的利率和税率。返回的 data.loan_mortgage 包含 loan_amount=400000、rate=0.065、term=30、monthly_payment=3128 和 total_payment=910178。monthly_payment_details 中的 principal_and_interest=2528、property_tax=500、home_insurance=100,三项月度支出合计为 3128。应将 total_payment 单独标注为返回的贷款总额指标,不可将其等同于综合月供乘以 360,也不能假定它包含所有经常性费用。 另有一个未经核验的文档示例使用顶层 mortgage 对象,字段包括 down_payment、hoa_fees、loan_amount、monthly_home_insurance、monthly_mortgage_insurance、monthly_payment、monthly_property_taxes、principal_and_interest、rate、term 和 total_payment。不要假定已观察到的响应也采用这一旧示例结构,或必然提供房贷保险分项。非零 HOA 费用的计算方式,以及启用退伍军人福利后的影响,均未核验。本接口仅用于情景估算,不代表贷款机构报价、资格认定、房产税核定或保险报价。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/mortgage-v2-calculate API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-v2-calculate?key=<API_KEY>&apply_veterans_benefits=false&down_payment=100000&hoa_fees=0&home_insurance=100&price=500000&property_tax_rate=0.012&rate=0.065&term=30'
查询结果
使用场景
- 制作购房预算卡片,将记录中的本息 2528、房产税 500 和住房保险 100 核对为每月 3128 的估算支出。
- 比较不同首付款情景时,始终以金额填写 down_payment,并以小数形式填写年度房贷利率和房产税率。
- 检查将 monthly_payment 乘以 360 误标为 total_payment 的房贷页面,改为独立展示接口返回的贷款总额指标。
- 为计算器增加输入提示,说明 0.065 代表 6.5%,并在用户明确提交计算前提醒其检查 6.5 这类百分数形式输入。
- 在购房负担能力测算表中,将缺失的房贷保险数据、未经测试的非零 HOA 费用和退伍军人福利影响标为未知。
常见问题
6.5% 的房贷年利率应填写 6.5 还是 0.065?
应填写 rate=0.065。成功核验的记录还使用 property_tax_rate=0.012 表示 1.2% 年度房产税率。直接填入 6.5 和 1.2 虽然返回 HTTP 200,但产生了明显偏高的还款金额。
down_payment 填首付款比例还是金额?
填写首付款金额。在成功核验的情景中,price=500000、down_payment=100000 得到 loan_amount=400000;填写 20 并不表示首付比例为 20%。
已核验的月供包含哪些项目?
记录中的 monthly_payment 为 3128,由 monthly_payment_details 内的 principal_and_interest=2528、property_tax=500 和 home_insurance=100 组成。当时 HOA 费用设为零,尚未确认房贷保险是否涵盖,也未确认非零 HOA 费用如何处理。
为什么 total_payment 不等于月供乘以贷款月数?
已观察到的 total_payment 为 910178,而 3128 乘以 360 个月为 1126080。这是两个不同的指标,不要将综合月供乘积标作返回的贷款总额,也不要假定 total_payment 包含所有经常性费用。
启用 apply_veterans_benefits 就能确认福利资格或降低月供吗?
不能。成功核验时该参数为 false,因此尚未核验 true 的影响。计算结果不能确认福利资格、贷款审批通过或贷款机构的个人专属报价。