免费外汇报价 API
选择、验证与接入指南
用免费外汇报价 API 获取货币对的当前买卖价，并在应用依赖行情前验证时间戳、数据源、调用限额与传输方式。
免费外汇报价 API：先检查哪些条件
可用的免费外汇接口应提供有文档的 HTTPS 端点，明确基准币与目标币，返回来源时间，并说明数据来源、更新频率、额度、认证、许可和错误结构。“免费”可能指公共端点、限额套餐或试用，因此建立依赖前必须核对最新文档。
| 需求 | 检查 | 常见错配 |
|---|---|---|
| 当前换算 | 最新时间与基准币规则 | 把日频参考价当成实时价 |
| 应用或看板 | 额度、CORS、缓存与状态页 | 把试用当成长期免费层 |
| 交易用途 | 买卖价、延迟、场所与许可 | 把中间价当成可成交报价 |
比较外汇 API 前先定义报价契约
需要买卖双边报价，还是只需要参考汇率？
外汇报价并不只是一个换算数字。交易分析、点差监控、估值和最优执行研究需要明确的买价、卖价、报价时间以及来源或交易场所。单一中间价可用于展示和粗略估值，却无法反映跨越买卖价差的成本。比较供应商前，应把这一差异写入验收标准。
币种对方向、报价精度与市场惯例
以 EUR/USD 为例，买价通常表示交易方买入一欧元愿意支付多少美元，卖价表示卖出一欧元要求多少美元。若接口返回的是倒数方向，数值和买卖方向都会变化。应保存供应商原始代码、标准化后的基准币和计价币、显示精度、点值以及直接报价或推导报价标记，而不是只存一个没有语义的 rate。
单次报价快照与持续报价流
本页关注报价本身的含义与校验，与传输方式无关。周期性检查点差时 REST 快照可能已经够用；持续监控状态则更适合 WebSocket。若你的核心问题是重连、订阅、心跳或逐笔延迟，应转到实时外汇数据指南，不要把传输层问题和报价语义混在一起。
按市场含义比较外汇报价 API，而不是比端点数量
| 维度 | 问题 | 保留证据 |
|---|---|---|
| 报价方向 | 买价和卖价是原生字段，还是由中间价推算？ | 原始响应与字段定义 |
| 点差 | 点差是否符合该币种对、场所和交易时段？ | 买价、卖价、中间价与计算点差 |
| 报价来源 | 报价来自哪个贡献方、经纪商、场所或聚合方法？ | 供应商、场所、贡献方与方法说明 |
| 报价年龄 | 服务收到数据时，市场观测已经过去多久？ | 来源、接收与处理时间戳 |
| 数据授权 | 报价能否展示、缓存或再分发给客户？ | 市场数据协议与展示条款 |
为什么免费的中间价接口不一定是外汇报价 API
不少免费端点每个币种对只返回一个指示性汇率，也把它称为 quote。这样的数据并非无用，但如果供应商没有说明买卖价如何形成，就不能用于点差分析。更稳妥的做法是把它归为参考汇率服务；只有响应包含足够的来源信息和买卖方向，才能称为报价数据源。
理解一条外汇报价是怎样形成的
与交易所股票不同，现货外汇没有唯一的统一行情带。同一时刻，银行、经纪商、电子交易场所、零售平台和多来源聚合商都可能给出有效但不同的价格。这些差异可能来自报价方库存、客户层级、交易时段流动性、聚合规则或延迟，并不一定意味着 API 错误。因此，生产级比较应先评估报价来源链，再比较数值是否接近。
| 来源类型 | 代表什么 | 适合场景 | 注意事项 |
|---|---|---|---|
| 单一交易方报价 | 某一家银行或经纪商给出的价格 | 面向特定客户的执行分析 | 客户层级与不可转授的权利 |
| 交易场所报价 | 一个交易场所内可见的最优价格 | 场所监控与微观结构研究 | 深度、参与者权限与场所时段 |
| 综合报价 | 跨多个贡献方标准化后的买卖价 | 跨供应商监控与估值 | 贡献方集合与陈旧来源处理 |
| 指示性报价 | 不具有成交约束力的市场指示 | 看板与方向判断 | 不可成交，且可能不含点差 |
同时保存买卖两侧，并显式计算中间价
接口同时提供买价和卖价时，应原样保存两者，并把 (bid + ask) / 2 作为推导字段计算。还应记录绝对点差，以及用点数或基点表示的相对点差。这样既能复现后续分析，也能避免把加工后的中间价误认为供应商原始观测。
倒数报价示例：取倒数时必须交换买卖方向
倒数报价示例：取倒数时必须交换买卖方向
假设来源给出的 EUR/USD 买价为 1.08492、卖价为 1.08496。把同一市场改写为 USD/EUR 时，新的买价应为 1 ÷ 1.08496 = 0.921693，新的卖价应为 1 ÷ 1.08492 = 0.921727。原报价的卖价之所以成为新买价的分母，是因为卖出美元、换入欧元时跨越的是原市场的另一侧。如果把 1 ÷ 原买价 直接当作新买价、把 1 ÷ 原卖价 当作新卖价，就会得到 0.921727 × 0.921693 的买卖倒挂，这是不可能成交的报价。
系统应保留原始货币对及其买卖方向，使用高于最终展示精度的十进制运算完成倒数换算，只在展示边界进行取整；同时记录“推导报价”标记和来源时间，避免用户把它误认为独立观测到的 USD/EUR 市场。计算交叉汇率时也应遵循同一原则：用时间对齐的来源报价分别推导买价和卖价，不能只对一个已经取整的中间价做换算。
识别倒挂、锁定、陈旧与单边报价
若买价高于卖价，且数据源没有说明处于竞价或特殊状态，应拒绝或隔离该报价。还要标记零点差、缺失一侧、时间戳倒退，以及超过币种对阈值仍不变化的报价。对报价 API 来说，这些检查比“JSON 能否解析”更有意义。
测试免费外汇报价 API 的 JSON 响应
与供应商无关的最新汇率请求
GET /latest?base=USD&symbols=EUR,JPY
Accept: application/json
{
"base": "USD",
"timestamp": "SOURCE_TIMESTAMP",
"rates": {
"EUR": "RATE_VALUE",
"JPY": "RATE_VALUE"
}
}端点与数值均为占位示例，不代表任何供应商或当前市场汇率。请按选定接口文档替换，并校验方向、时间戳、数值类型、缺失币种和错误行为。
生产响应中应明确的字段
| 字段 | 校验要求 |
|---|---|
base / quote | 有效币种标识，并明确币种对方向 |
rate / rates | 正数十进制值，并说明汇率类型和精度 |
timestamp | 来源观测时间、时区与时效，而不只是服务器响应时间 |
source | 足以追溯来源的供应商或方法标识 |
success / error | 机器可读错误码、消息与是否可重试分类 |
免费汇率接口接入清单
- 发送请求前校验基准币与目标币代码。
- 设置明确超时，分别处理 4xx、5xx 与限频响应。
- 保存来源时间、抓取时间、供应商与原始响应校验值。
- 使用十进制运算，并让缓存或数据库写入具备幂等性。
- 对陈旧时间戳、结构变化、缺失币种对与额度耗尽告警。
外汇数据用于生产前的校验
参考汇率不是可成交价格
中间价或官方参考价不包含银行点差、银行卡费用、滑点或特定交易场所的买卖价。应准确标注数据口径，不能将其描述为成交保证。
时效、连续性与异常值检查
拒绝非正数或异常结构，检测陈旧来源时间，在设定容差内比较倒数币种对，并分类缺失观测。第二来源可触发复核，但不应静默创造替代值。
感知额度的缓存与刷新设计
缓存时间应与供应商的实际更新计划匹配。每分钟调用一次日频参考接口只会浪费额度，不会提升时效。非关键展示可设置短暂的错误时沿用窗口，但必须展示观测时间，让用户和下游服务能够区分缓存数据与新响应。
重试、熔断与供应商回退
只对暂时性故障使用带随机抖动的指数退避。无效币种、认证失败或月度额度耗尽不能当作网络超时反复重试。备用供应商的数据必须先统一币种对方向、时间戳规则和汇率类型，才能替代主数据源。
许可、署名与再分发
免费访问端点并不自动授予无限期缓存、公开批量下载、转售数据或移除署名的权利。应在接入记录中保存条款版本和复核日期，并在改变数据展示或分发方式前重新检查。
QVeris 如何帮助查找免费外汇报价 API
QVeris 帮助开发者与 Agent 发现并检查可调用能力。可打开 QVeris 工具详情，查看相关能力，检查输入输出，再按 QVeris 文档完成接入。QVeris 能减少发现与结构检查工作，但不会改变供应商的汇率、许可、额度或服务水平。
免费外汇报价 API 常见问题
有，但公共端点和免费套餐在时效、覆盖、来源、署名和额度上不同。
不一定。“最新”可能是日频、小时、延迟或盘中数据，应检查来源时间与方法。
按币种对、时效、来源、免费额度、许可、错误处理和运行可靠性选择。
不能默认可以。无密钥端点仍可能要求署名、限制缓存、商用或再分发。
不能默认使用。参考价通常不包含买卖价差、费用、滑点和结算条件。
监控成功率、限频、陈旧时间戳、结构变化、缺失币种对与条款更新。