浏览全部文档

外汇数据方法说明

汇率含义、新鲜度、历史记录、换算、来源和限制。

Narwhal 通过匹配的 REST 和 MCP 合约发布当前指示性汇率、安全的小数换算和历史观测值。它明确表示汇率方向和时间语义,而不是脱离上下文展示一个数字。

历史数据包含真实观测日期

历史结果按从旧到新排序,仅包含有存储观测的日期。Narwhal不会创建周末或假日行,也不会把每周货币值向前填充到原本按日记录的历史中。

某个日期可能只包含所请求货币的子集。当它们的发布频率或历史覆盖范围不同时,这是预期行为。该接口返回当前已接受的历史序列,而不是每个更早的发布版本。

一个基本单位等于报价汇率

以此作为基础货币: USD 和 一个 返回的 EUR 比率 0.92,表示 1 美元等于 0.92 欧元。汇率以十进制数字符串返回,所选币种以明确的记录返回,而不是作为动态对象键。

更新和新鲜度保持可见

Narwhal 在交易日约每分钟检查一次上游新观测。客户请求读取最新已接受观测,不会等待上游调用。

每个汇率都有自己的 timestampstale 状态。 market_session 报告 open, weekend,或 interbank_closed。在周末和市场休市期间,最近一次已接受的观测值仍可保留,并附带原始时间戳和如实标注的交易时段信息。

换算使用一个选定汇率

换算端点使用十进制算术,然后采用银行家舍入法,一次性舍入到目标货币 ISO 4217 的最小单位。它返回输入金额、选定汇率、换算金额、时间戳、陈旧状态和市场交易时段。

已授权并获批的数据提供商

Narwhal 使用获得许可或以其他方式获批准的上游提供商,并在内部审计轨迹中保留提供商身份、路由、许可记录和推导详情。这些运营溯源字段特意不包含在公开汇率响应中。

如果获批的上游路由发生变化,该政策仍能保持客户合约稳定,同时 Narwhal 保留审计每个已接受观测值所需的证据。

当前限制

  • 汇率和转换结果仅供参考,不是可执行的交易商报价、结算值或官方定盘价。
  • 当前汇率、转换和历史观测值均为公开数据。波动率计算结果不公开。
  • 缺失、格式错误或不可用的选定汇率会直接失败,不会估算,也不会静默省略。
  • 公开测试版不提供服务级别保证,也不是金融、投资、法律或税务建议。

查看已上线的 FX API 或从 快速入门.