免费汇率 API
比较、测试与可靠接入

免费汇率 API：先看结论

真正适合你的免费汇率 API，不一定是币种数量最多的服务，而是汇率类型、发布时间、基准币规则、许可、额度和错误行为都符合应用需求的服务。价格展示、会计、报表和低频换算通常可使用日频或小时级参考汇率；交易、对冲或成交系统则需要带买卖价和精确时间戳的市场数据，不能把普通参考汇率接口当作交易行情。

选择免费汇率 API 前先定义汇率类型

参考汇率与交易报价解决不同任务

央行或聚合来源的参考汇率用于估值和换算，并不保证能够按该价格成交。交易报价通常需要明确买价、卖价、市场来源和精确时间戳。如果应用只保存一个币种对数值，应明确它是中间价、参考定盘价还是推导交叉汇率。

比较供应商前先写清数据契约

先列出基准币与报价币、允许的最大数据年龄、历史起始日期、刷新周期、舍入规则和停机时的预期行为。这样，“找一个免费 API”才会变成可验证的需求，而不是供应商热度比较。

让免费汇率 API 匹配真实使用场景

同一个接口可能适合一种工作流，却不适合另一种。设置时效与可靠性要求前，应先判断汇率如何影响用户、资金和下游记录。

选择免费额度前先计算请求预算

月请求量可按“活跃实例数 × 每日刷新次数 × 活跃天数”估算，再加上重试、缓存未命中、测试流量和部署检查。每次页面浏览都直接请求汇率，会比按发布时间周期统一缓存的服务端方案更快耗尽免费额度。

比较免费汇率 API 的限制与数据权利

把专门意图留给专门页面

本页只解决通用选择与接入。实际任务是免密钥、Python、Excel 或历史区间时，应分别查看免密钥指南、Python 指南、Excel 指南或历史汇率指南。

用加权评分代替泛化的“最佳 API”排名

只对真正影响应用的条件评分。例如，可将汇率定义和时效各设为 25%，覆盖范围 20%，许可 15%，可靠性行为 10%，接入成本 5%。即使总分很高，只要供应商未满足强制条件，也应直接淘汰。

接入前测试免费汇率 API 响应

不要只验证 HTTP 200，还要验证字段含义

成功状态码并不代表数据一定可用。响应应明确基准币、来源日期或时间戳，并区分币种缺失与零值，同时说明汇率是直接报价还是推导结果。统一币种标识时可参考 ISO 4217 币种代码标准。

应把原始金额与币种、未舍入汇率、换算金额、舍入规则、来源日期、抓取时间、供应商和汇率类型一起保存。如果发票政策要求使用特定会计日期公布的汇率，更新的响应并不自动构成有效替代；应明确非工作日处理规则，并记录实际采用的回退日期。

使用与供应商无关的验收测试

required = ["base", "rates", "source_timestamp"]

assert response.status == 200
assert all(field in payload for field in required)
assert payload["base"] == requested_base
assert requested_quote in payload["rates"]
assert payload["rates"][requested_quote] > 0
assert age(payload["source_timestamp"]) <= max_age
assert reverse_rate_is_consistent_within_tolerance()

把不同 JSON 结构统一成内部模型

供应商可能返回汇率映射、单一币种对或观测值列表。应把这些格式统一成一种内部记录，避免业务代码依赖某个供应商的字段名称。

{
  "base": "USD",
  "quote": "EUR",
  "rate": "0.923400",
  "rate_type": "reference_midpoint",
  "source_timestamp": "2026-07-28T00:00:00Z",
  "retrieved_at": "2026-07-28T00:05:12Z",
  "provider": "provider-id",
  "is_stale": false
}

存储货币汇率时使用十进制字符串或十进制数值类型。二进制浮点数在重复换算后可能产生舍入误差。

测试错误路径与陈旧数据

主动请求无效币种、模拟超时和小额度耗尽，并向应用传入过期时间戳。确认界面或下游服务不会在不提示数据年龄的情况下静默复用过期汇率。

接入汇率时不要隐藏不确定性

为每个换算结果保存来源信息

在换算金额旁保存供应商、来源时间戳、基准币、报价币、原始汇率和舍入规则。当供应商修订数据或币种精度不同时，这些字段能够支持后续核对。

让缓存周期匹配数据发布时间

如果数据源每个工作日只发布一次，每分钟轮询只会浪费额度，并不会提高时效。应按发布时间设置缓存过期点，异步刷新，并在超过最大允许年龄时把最后有效值明确标记为陈旧。

回退供应商必须提供等价汇率类型

不能仅因为两个接口都返回 USD/EUR，就从央行参考汇率直接回退到零售卡组织汇率。只有汇率定义、时间戳规则、方向和许可用途兼容时，回退才是安全的。

除了可用率，还要监控时效与正确性

使用分阶段方式上线生产

先用保存的响应完成测试，再让新供应商以影子模式与现有数据源并行运行。比较汇率、时间戳、币种缺失和错误频率后，再让它承担用户可见的换算。回滚路径应能恢复旧数据源，而不需要重写已经保存的记录。

QVeris 如何帮助评估汇率能力

QVeris 帮助开发者和 Agent 发现可调用能力并检查其声明的输入输出。先用 QVeris 工具详情缩小候选范围，再核对供应商当前文档、许可、更新时间和真实响应。QVeris 提供发现与检查能力，但不会改变底层数据源，也不保证供应商可用性。

免费汇率 API 常见问题