免费实时外汇 API：实时行情接入指南

外汇报价来源、买卖价含义与交易时段

现货外汇没有单一集中交易所。银行、经纪商、ECN、零售交易场所、央行参考来源和多供应商聚合源，即使在同一时刻也可能给出不同但各自有效的汇率，因为它们的报价贡献方、客户层级、盘口深度、可成交规模和计算方法不同。标准化记录必须说明来源，以及该数值属于可成交报价、指示价、中间价还是参考汇率。

把“实时”要求写成可验收指标

秒级、分钟级还是逐笔推送？

每分钟刷新的行情看板与自动交易信号并不是同一种需求。应明确最大数据年龄、可接受网络延迟、所需交易时段，以及更新缺失时是否必须暂停应用。60 秒更新一次的接口对汇率组件可能足够实时，但不适合依赖逐笔变化的逻辑。

选择 REST 轮询还是外汇 WebSocket API？

REST 更适合快照和可控刷新；当供应商频繁推送变化时，WebSocket 更合适，但必须处理连接状态、订阅、心跳、重连、重复事件和序列缺口。仅提供 WebSocket 地址并不能证明低延迟，仍需测量消息时间戳和连续性。

实时外汇行情必须返回哪些字段？

至少应要求接口明确返回货币对、汇率类型、数值、来源时间戳以及供应商或交易场所。交易型场景还可能需要买价、卖价、点差和 OHLC。可依据 ISO 4217 币种代码标准统一标识，同时保留供应商原始符号。

比较免费实时外汇数据 API 的限制

免费层、试用与无密钥访问不是一回事

试用会到期；免费层可能长期存在但受额度限制；无密钥端点只是免注册，仍可能限频并受使用条款约束。选择前应记录套餐名称、核对日期、分钟/月度额度、开放货币对和商用规则。

计算免费额度是否真的够用

接入前先估算用量：每日调用量 = 货币对数量 × 每分钟刷新次数 × 活跃分钟数。5 个货币对每分钟轮询一次、运行 8 小时，需要 2,400 次调用；如果一次请求能够返回全部 5 个货币对，则可能只需 480 次。还要确认供应商按 HTTP 请求、返回币种、API credit 还是 WebSocket 订阅计费，因为不同模型的结果差异很大。

测试外汇数据是否真正实时

测量时间戳年龄与更新间隔

每条观测至少记录三个时间：供应商来源时间、客户端收到响应或消息的时间、系统完成存储的时间。来源年龄等于接收时间减去来源时间。应跨活跃和安静时段连续观察，不能把一次快速响应误判为持续实时传输。

分别测试 REST 与 WebSocket

# Provider-neutral verification record — not a live quote
{
  "pair": "EUR/USD",
  "rate_type": "bid_ask",
  "source_time": "SOURCE_TIMESTAMP",
  "received_time": "CLIENT_TIMESTAMP",
  "transport": "rest_or_websocket",
  "sequence": "OPTIONAL_SEQUENCE"
}

REST 测试应记录状态码、限频响应头、来源时间戳，以及重复请求是否得到新观测。WebSocket 测试应验证认证、订阅确认、心跳、事件顺序、重复消息、断线恢复与缺口检测。

拒绝陈旧、不完整或含义不清的行情

应拒绝格式异常的货币对、非正数、超过允许年龄的时间戳，以及无法确认汇率类型的响应。不要把中间价静默伪造成买卖价，不要补造缺失 K 线，也不要合并时间不一致的观测。

执行可重复的验收测试

1. 选择免费层支持的两个主要货币对和一个相对不活跃的货币对。
2. 在活跃交易时段连续采集 REST 响应或 WebSocket 事件。
3. 记录来源时间、接收时间、货币对、汇率类型、买卖价，以及可用时的序列标识。
4. 计算来源年龄中位数与最大值、实测更新间隔、重复率和消息缺失数量。
5. 主动制造断线或超时，验证退避、重新订阅、快照恢复与陈旧数据提示。
6. 将结果与书面需求逐项比较，任何强制条件失败都应淘汰该数据源。

安全接入实时外汇数据 API

围绕免费额度设计刷新策略

调用预算应按“货币对 × 刷新次数 × 客户端”计算。多个用户需要相同快照时应集中轮询；缓存时间不得超过允许的新鲜度窗口；限频响应头显示额度将尽时应主动降速。流式接口只订阅当前需要的货币对。

处理交易时段、重连与数据缺口

外汇市场并非一周每分钟都活跃。系统必须区分休市或清淡行情与数据源故障。暂时性失败采用指数退避；重连后恢复订阅；有序列号时检查连续性；发现流式缺口后通过 REST 快照重新同步。

保存标准化行情记录

应保存货币对方向、汇率类型、买价、卖价、中间价或 OHLC、来源时间、接收时间、供应商、传输方式，以及数值为直接提供还是推导得到。这样才能在保留来源链的前提下完成陈旧数据告警、供应商回退、审计和后续比较。

设置明确的上线门槛

如果还需要日期区间 K 线或回测数据，应将该意图分开，并参考 实时市场数据指南。本页继续聚焦免费实时数据源的选择与运行。

免费实时外汇数据 API 常见问题