免费货币汇率 API：先按任务选择
免费货币汇率 API 是否可用，取决于它发布的汇率是否匹配产品要做的决策。旅行展示可能只需要每日参考汇率；结账系统需要明确时间戳、稳定的基准币规则、十进制换算和允许商业展示的许可；交易界面则需要可成交行情，而不是普通货币换算数据。
筛选原则：只要更新频率、汇率类型、额度、币种覆盖或数据权利不满足硬性需求，就应立即排除。
先定义产品里的“货币汇率”
需要每日参考汇率还是日内市场汇率？
“当前”和“最新”并不保证实时。应阅读供应商的更新计划并检查响应时间戳。央行参考汇率适合报表和信息型换算器，但它不是可以成交的买价或卖价。
基准币、报价币与换算方向
如果响应以 USD 为基准币、EUR 的值为 0.92，含义是 1 美元等于 0.92 欧元。反向换算应使用除法而不是乘法。还要确认免费层是否允许更换基准币，或是否需要自行计算交叉汇率。
交叉汇率示例：假设 1 美元等于 0.9200 欧元，同时等于 156.40 日元。通过共同的美元基准计算欧元兑日元，应使用 156.40 ÷ 0.9200 = 170.00，即 1 欧元等于 170 日元。因此，250 欧元在未计费用、也未执行产品舍入前对应 42,500 日元；日元兑欧元则取 1 ÷ 170.00。计算过程中保留未舍入汇率，只在最终金额上按照目标币种和业务规则舍入。
如果供应商同时返回直接的 EUR/JPY 汇率，应将它与交叉计算结果比较，而不是强求二者完全相等。轻微差异可能来自更新时间、来源市场或舍入方式；差异较大或持续存在时，应拒绝该值、刷新组成汇率，或改用直接货币对来源。不要把不同观测日期的组成汇率混在一起计算；如确实这样做，必须明确标注为跨时间数据。
ISO 币种代码与资产覆盖
法定货币应使用 ISO 4217 货币代码 进行标准化。加密资产、商品和废止货币应单独核对，因为它们不一定使用相同代码、来源或更新规则。
让免费汇率接口匹配真实负载
| 任务 | 最低数据要求 | 免费层检查 | 需要避免的问题 |
|---|---|---|---|
| 价格展示 | 有说明的日频或小时汇率 | 署名与缓存规则 | 把旧数据标成实时 |
| 结账估算 | 时间戳、方向与舍入 | 峰值流量下的额度 | 误称为最终结算价 |
| 表格刷新 | 批量币种与稳定 JSON | 每轮刷新请求数 | 每个单元格单独请求 |
| 交易产品 | 买卖价或可成交行情 | 通常超出普通免费汇率范围 | 用参考价执行订单 |
根据用户行为计算额度
月调用量可按活跃用户数 × 每次会话刷新次数 × 每月会话数估算，再加入定时任务和重试。能否批量查询币种、能否共享缓存，往往比宣传的月额度更重要。
要求清晰无歧义的汇率 JSON 契约
可用响应应明确基准币、报价值、生效时间、发布时间或时效信号，以及错误状态。不要只根据端点名称猜测单位和含义。
| 时间字段 | 应表达的含义 | 为什么重要 |
|---|---|---|
| 观测日期 | 该汇率所代表的市场或参考时段 | 周一收到的响应仍可能承载上周五的数值 |
| 发布时间 | 来源正式发布该观测值的时间 | 可判断每日定盘值是否延迟发布 |
| 获取时间 | 系统接收或缓存响应的时间 | 用于判断缓存年龄和排查故障，但不能单独证明数据新鲜 |
| 修订时间 | 已发布观测值被修改的时间 | 避免报表和对账结果在无提示下发生变化 |
应把周末和币种节假日建模为明确的日历状态。“本来就不会发布新值”“当天发布延迟”和“供应商更新失败”是三种不同情况。每类任务都应设定可接受的最大观测时效；沿用上一个有效值时保留原始日期，不能用本次获取时间覆盖它。
{
"base": "USD",
"as_of": "PROVIDER_TIMESTAMP",
"rates": { "EUR": 0.92, "JPY": 156.4 }
}货币计算使用十进制
对于以 USD 为基准币的响应，美元转欧元使用金额 × rates.EUR。保存换算值时应同时保存供应商时间戳，按币种定义舍入规则，并避免使用二进制浮点数处理会计金额。
执行十分钟免费汇率 API 验收测试
查询 USD/EUR 等币种对，确认文档中的报价方向、时间戳、HTTP 状态、内容类型与 JSON 结构。
确认免费层是否支持更换基准币，并检查反向汇率是否在合理误差内接近原汇率的倒数。
提交无效币种代码，记录状态码、错误正文、重试提示，以及响应是否仍可被程序解析。
核对请求计数、署名、缓存、再分发、商业使用，以及免费额度耗尽后的行为。
在预计发布时间前后分别请求，确认观测日期是否更新、周末是否沿用上一值，以及接口怎样表示未更新或已经陈旧的汇率。
使用 Decimal、文档规定的报价方向和产品舍入规则计算一笔已知金额，并保存原金额、汇率、观测日期、换算结果，以及是否采用降级值的决定。
判断免费汇率接口能否用于生产
按照公布频率缓存，不要凭感觉刷新
每分钟刷新日频数据只会浪费额度，并不会产生更新数据。应缓存到预计发布时间窗口，保留最近一次已验证响应用于受控回退，并向用户展示真实的数据时间。
区分参考换算与最终结算
参考货币转换 API 可以估算展示价格，但支付机构、银行、卡组织、经纪商或流动性场所可能在结算时使用不同汇率、点差、费用和时间点。
买价、卖价和中间价不能混用。如果 EUR/USD 的买价为 1.0840、卖价为 1.0850，中间价是 1.0845，报价点差为 0.0010，也就是该货币对的 10 个点。用户用美元买入欧元时，先承受卖价一侧的成本，再叠加可能存在的单独费用；卖出欧元时则按买价计算。统一使用中间价只能得到参考估值，不能代表可成交或保证结算的结果。
产品文案也应与数据性质一致：参考汇率或中间价应标为“换算估值”并展示数据时间；只有在报价已锁定、有效期和费用明确时，才适合使用“预计到账”这类确定表达。无法取得新观测值时，应执行预先规定的一种动作——展示带日期的缓存估值、停止计算，或切换到经过批准的备用来源——不能把旧值悄悄包装成当前汇率。
提前设计免费层退出方案
使用内部适配器隔离供应商字段，监控额度响应头和数据时效，记录降级模式，并提前决定超限后使用缓存、停止换算还是切换到已批准的备用来源。
QVeris 如何帮助评估汇率能力
QVeris 可以帮助开发者发现与汇率相关的能力，并在接入前检查工具描述。价格、额度、许可、覆盖范围和时效仍以供应商为准，因此必须回到来源页面验证。
- 在 QVeris tool details 中搜索货币和汇率能力。
- 通过 Capability Map 检查相邻的金融数据类别。
- 更窄的任务可进入免密钥汇率 API、Python 接入或历史汇率指南。
免费货币汇率 API 常见问题
有，但“免费”可能是开放端点、长期限额套餐或临时试用。应确认到期时间、额度、署名和商业使用规则。
不一定。很多接口发布每日参考汇率，应检查文档中的更新频率和时间戳，不能把 latest 直接理解为实时。
部分端点可以。无需密钥仍可能存在限流、署名、CORS 或合理使用要求。
选择熟悉的币种对，读取 base 与 quote 字段，再反转币种对，并检查反向结果是否在合理误差内接近倒数。