exchangerate.dev1. 来源类别
公开字段source描述的是数据类别，而非供应商。live是指示性现货市场数据，可在银行间交易周内以较短的间隔更新。ecb_daily是欧洲中央银行的参考汇率，通常每个工作日发布一次。market_daily为没有ECB定盘汇率的货币存储市场数据流的每日收盘汇率。
多货币响应包含一个sources映射，列出每种报价货币的来源。其顶层source采用保守方式，报告该响应中时效性最低的类别。
参考：ECB欧元参考汇率。
2. 时间与市场状态
data_updated_at是底层观测记录最后一次写入的时间。timestamp是API响应生成的时间。使用前者计算数据已过去的时间，使用后者审核请求时间。
在银行间交易周内，market_session为open。从纽约时间周五17:00收盘后至纽约时间周日17:00，其值为weekend。在已知的非周末休市期间，其值为interbank_closed。周末响应可能包含该交易周的最后一条观测记录，该标签并不意味着周末有新的报价。
3. 更换基准货币与推导交叉汇率
汇率经过归一化处理，调用方可以请求任何受支持的基准货币。当某个货币对没有直接观测值时，API会通过可用的组成货币对进行三角换算。推导值在derived_symbols中标识。单货币对响应还会在适用时提供derived和derivation_bps_max界限。
交叉汇率继承其组成货币对中时效性最低的来源。无法接受推导汇率的应用应检查推导字段，而不是根据货币对进行推断。
4. 历史观测记录
每日历史数据结合了定盘汇率和市场收盘汇率。主要货币的数据可追溯至1999年，其中约30种使用ECB定盘汇率，其余113种使用市场收盘汇率，各货币对的数据起始日期有所不同。在没有新定盘汇率的周末或节假日，可能会沿用先前的观测记录，并标记为is_forward_filled: true。API不会编造未发布的定盘汇率。
5. 验证与发布
- 定价前，货币标识符会统一为ISO风格的大写代码。
- 来源和更新时间字段随观测记录一同提供，而不是由客户端推断。
- 当实时观测记录缺失或过旧时，会回退到可用的每日参考类别，而不会将其标记为实时。
- 所有套餐使用相同的来源，Free和无密钥调用方收到的实时汇率延迟15分钟。
- 发布的研究必须包含测量时间范围、样本数量、方法和局限性。
6. 局限性
这些是指示性参考汇率，并非可执行交易的买入价或卖出价。它们不包含银行、发卡机构、经纪商、支付服务提供商或现钞交易商的点差和费用。不得用于结算、执行付款、受监管交易，或用作正式记录的数据来源。覆盖范围和时效性可能因货币、来源可用性、市场休市情况和参考机构的发布时间表而异。
7. 时效性基准测试标准
我们会先发布协议，再发布排名。可复现的外汇API时效性基准测试定义了观测时间范围、时间戳要求、指标、排除条件和最小样本量。其机器可读协议目前不包含任何提供商结果，只有达到所述证据门槛后才会添加结果。
修订记录
1.1 · 2026年10月9日： 明确了Free的延迟和每日市场收盘汇率。
1.0 · 2026年7月16日： 首次公开的方法、来源含义、市场交易时段规则、推导政策、历史数据处理方式、局限性和基准测试发布标准。