使用小数形式的利率和房产税率估算房贷月供

查看 美国房产与房贷数据 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 功能

小数形式的房贷利率输入 按已成功核验的计算方式,使用 0.065 表示 6.5% 年利率、0.012 表示 1.2% 年度房产税率,避免直接填入百分数数值。
按首付款金额确定贷款本金 分别传入房价与首付款金额;已观察到的房价 500000、首付款 100000 情景返回贷款金额 400000。
月供分项与合计核对 分别读取已观察到的本息、房产税和住房保险月度金额,展示估算结果前与 monthly_payment 核对。
独立展示返回的贷款总额 将 total_payment 与月供明细分别呈现;记录中的 910178 并不等于综合月供乘以贷款月数。
标明尚未核验的费用与福利影响 对非零 HOA 费用、缺失的房贷保险信息和启用退伍军人福利后的影响保留未核验标记,不假定已覆盖相关费用或满足资格。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

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 的影响。计算结果不能确认福利资格、贷款审批通过或贷款机构的个人专属报价。

相关接口

相关指南

查看订阅方案 →