按美国邮政编码查询房贷利率参考信息
查看 美国房产与房贷数据 API 的全部接口 →通过必填查询参数 postal_code 请求房贷利率参考信息,填写美国 ZIP 邮政编码,例如 90004。邮编应保留为字符串,以免丢失开头的零。目前没有本接口的请求核验记录,因此实际可用性、邮编覆盖范围、数据时效及返回利率的数值单位均未核验。 现有文档示例并不完整,展示的顶层字段包括 disclosures、meta、primary、providers 和 rates。disclosures 对象包含 advertising_disclosure 与 rate_disclosure,meta 包含 count 与 version。providers 数组中的字段包括 Name、Logo、Url、DisclaimerFull 和 DisclaimerShort。示例中的 rates 记录包含 advertiser、rate、aprVal、loanTypeDisplayName、loanPayment、loanFees、points、isSponsored 和 cpcUrl。以上仅为文档示例字段,不保证当前响应一定提供;示例也未明确数据观测时间或每项金额的含义与单位。 展示数据时应分别标注贷款利率与年化综合成本率(APR),保留适用的披露信息和赞助标识,并在比较还款额或费用前核实贷款假设。未经确认数值口径,不要将返回的利率直接填入房贷计算器。本接口提供按邮编查询的利率参考,不代表个人专属报价、贷款机构承诺、贷款审批通过或保证实时的报价。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/mortgage-v2-check-rates API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/mortgage-v2-check-rates?key=<API_KEY>&postal_code=90004'
查询结果
使用场景
- 设计按 ZIP 邮编查询的本地房贷利率面板,在核实所选邮编的响应结构与覆盖情况后再用于生产展示。
- 制作分别标注贷款利率、APR、贷款类型、费用和贷款点数的利率表,避免仅按一个含义不明的数值排序。
- 为利率记录设置披露区域,在展示文档所列赞助标识的同时保留广告与利率相关提示。
- 确认利率单位及相关贷款假设后,由用户主动选择将利率用于月供计算,不把展示利率视为贷款已获批准。
- 当邮编查询结果缺少可信观测日期时,展示数据时效未知状态,而不是使用容易误导的实时利率标记。
常见问题
查询房贷利率需要提供什么参数?
提供字符串形式的美国 ZIP 邮编 postal_code,例如 90004。这是本接口文档中唯一的输入参数;请保留字符串类型,避免丢失邮编开头的零。
返回的利率记录经过实际请求核验了吗?
本接口没有请求核验记录。现有文档示例不完整,列出了 disclosures、meta、primary、providers 和 rates,但未确认当前响应结构、邮编覆盖范围或数据时效。
rate 和 aprVal 有什么区别?
文档示例分别使用 rate 表示贷款利率信息、aprVal 表示年化综合成本率(APR)信息。不要将二者合并为同一标签,也不要假定其数值口径已经确认;比较记录前应核实单位与贷款假设。
可以把展示的还款额或利率视为我已获批的贷款报价吗?
不可以。按邮编查询不能确认借款人资格、个人专属定价、贷款审批或贷款机构承诺。文档中的 loanPayment、loanFees、points 和 loanTypeDisplayName 需要结合具体条件理解,并非已经核验的个人贷款条款。
能否直接把返回利率复制到月供计算中?
必须先检查单位。月供计算接口已核验使用小数形式的年利率,但本利率查询接口尚无请求记录确认输出口径。应先确认数值口径,再由用户主动选择将其作为计算假设。
广告与利率披露信息应如何展示?
应在相关记录旁保留适用的 advertising_disclosure、rate_disclosure、文档所列免责声明字段,以及任何 isSponsored 标识。文档示例列出了这些字段,并不代表当前每次响应都会包含全部字段。