免费外汇数据 API
选择与接入指南

免费外汇数据 API：首先检查什么

选择外汇 API 前先定义任务

需要当前汇率、历史数据还是实时报价？

“最新”可能指日频参考价、小时聚合价、延迟快照或盘中报价。应确定可接受的数据延迟，并判断应用需要参考值、中间价、买卖价还是 OHLC 历史序列。

如果应用明确需要流式报价，可继续查看实时外汇数据指南；如果需要日期区间与 K 线，则查看外汇历史数据指南。本页承担的是选型入口：先确定正确的数据契约，再选择供应商。

币种对、基准币与标识符

检查支持币种、币种对方向、基准币限制、精度，以及交叉盘是直接提供还是推导计算。标识符可按 ISO 4217 标准统一；日期区间需求可查看历史数据指南。

交易周、交易时段与 K 线边界

外汇市场由多个全球交易时段重叠构成，并不存在唯一的集中交易所交易日。使用盘中或 OHLC 数据时，要确认供应商定义的周开盘与周收盘、时区、夏令时处理、每日换日时间、是否生成周日 K 线，以及每根 K 线来自成交、报价还是抽样中间价。

比较免费外汇 API 的限制与使用权利

无需 API 密钥不等于没有限制

无密钥端点仍可能要求署名、限制调用频率、禁止再分发，或在没有服务保证的情况下变化。应记录条款复核日期，并为额度耗尽或服务中断做好准备。

比较时应看真正可用的数据集，而不是宣传标题。需要测试准确币种对、周期、历史深度、单次最大品种数、分页、来源时间戳、买卖价可用性以及免费层排除的端点，并根据峰值用户数和刷新行为估算调用量；一次看板刷新可能扩散成几十个币种对请求。

选择正确的外汇汇率类型

参考价、聚合中间价和交易场所买卖价都可能有效，却会因定盘时间、报价来源、点差和方法不同而产生差异。每条观测都应保存汇率类型与数据来源。

直接币种对与推导交叉汇率

部分免费套餐只允许一个基准币。通过交叉计算可以扩展覆盖，但也会增加舍入误差和时间戳不一致的风险。应记录币种对是直接返回还是推导得到、中间币种以及计算精度。

买价、卖价、中间价、最新价与 OHLC 不是同一字段

可交易报价需要来自明确来源的买价和卖价；中间价是计算结果，而在分散化外汇市场中，“最新价”可能没有统一定义，甚至只是供应商自定义字段。OHLC 还取决于输入数据类型和 K 线时区，因此不能把所有数值都压成一个通用 price 字段。

测试免费外汇数据 API 响应

与供应商无关的 JSON 示例

GET /latest?base=USD&symbols=EUR,JPY
Accept: application/json

{
  "base": "USD",
  "timestamp": "SOURCE_TIMESTAMP",
  "rates": {
    "EUR": "RATE_VALUE",
    "JPY": "RATE_VALUE"
  }
}

端点和数值均为占位示例。应对照供应商文档校验币种对方向、来源时间、时区、数值类型、缺失币种处理方式和机器可读错误。服务器响应时间不能代替市场观测时间。

最低接入检查项

1. 发送请求前校验币种代码。
2. 分别处理 4xx、5xx、超时和限频响应。
3. 保存来源时间、抓取时间、供应商与汇率类型。
4. 使用十进制运算，并保证缓存写入幂等。
5. 对数据陈旧、结构变化和额度耗尽发出告警。

应把这些检查整理成正式证据包，而不是随手试一次接口。至少包含一个常见直接币对、它的反向币对、一个推导交叉盘、一个不支持的币种、一个周末或换日时点，以及一次主动触发的额度限制响应，并记录预期状态和字段含义。只有当应用能够区分“币对未覆盖”“市场观测未变化”“数据已经陈旧”“额度耗尽”和“服务不可用”时，供应商才算通过；这些状态需要不同的用户提示和降级行为。

外汇数据用于生产前的校验

参考汇率不是可成交价格

参考值通常不包含银行点差、银行卡费用、滑点以及特定交易场所的买卖条件，因此必须准确标注。数据到达用户前，应拒绝非正数汇率、陈旧时间戳、异常响应结构和方向错误的币种对。

缓存、重试与备用数据源

缓存时间应与供应商更新周期一致。只对暂时性故障进行退避重试，不要把无效代码或额度耗尽当作网络错误反复请求。启用备用数据源前，应统一币种对方向、时间戳和汇率类型。

执行一致性与事件窗口检查

应在明确容差内比较正反向币种对，用同步时间戳检验三角关系，并检查夏令时切换、周末重开、重要政策公告和上游中断附近的 K 线。较大差异可能合理，但系统必须能够说明它来自点差、时间、数据源，还是字段映射错误。

QVeris 如何帮助查找免费外汇数据 API

可使用 QVeris 工具详情发现可调用能力并检查输入输出，再按照文档完成连接。供应商自身的报价、许可、额度和服务等级仍然适用。

免费外汇 API 常见问题