文档
外汇数据方法说明
汇率含义、数据时效性、历史记录、换算、来源和限制。
Narwhal 通过相互对应的 REST 和 MCP 接口规范提供当前指示性汇率、保留十进制精度的货币换算和历史观测值。它明确标明汇率方向和时间含义，避免脱离上下文展示数值。
历史数据包含真实观测日期
历史结果按时间从早到晚排列，仅包含存有观测值的日期。Narwhal 不会创建周末或假日的数据行，也不会将按周发布的汇率向前填充到其余按日记录的历史数据中。
某个日期可能只包含所请求货币的子集。当它们的发布频率或历史覆盖范围不同时，这是预期行为。该接口返回当前已接受的历史序列，而不是每个更早的发布版本。
每单位基准货币对应所报汇率的报价货币金额
若基准货币为 USD ，返回的 EUR 比率 0.92，表示 1 美元等于 0.92 欧元。汇率以十进制数字符串返回，所选币种以明确的记录返回，而不是作为动态对象键。
更新情况和数据时效性清晰可见
Narwhal 在交易日约每分钟检查一次上游新观测。客户请求读取最新已接受观测，不会等待上游调用。
每个汇率都有自己的 timestamp 和 stale 状态。 market_session 报告 open, weekend，或 interbank_closed。在周末和市场休市期间，最近一次已接受的观测值仍可保留，并附带原始时间戳和如实标注的交易时段信息。
换算使用一个选定汇率
换算端点使用十进制运算，然后采用银行家舍入法，一次性舍入到目标货币 ISO 4217 的最小单位。它返回输入金额、选定汇率、换算金额、时间戳、过时状态和市场交易时段。
已授权并获批的数据提供商
Narwhal 使用获得许可或以其他方式获批准的上游提供商，并在内部审计轨迹中保留提供商身份、路由、许可记录和推导详情。这些运营溯源字段特意不包含在公开汇率响应中。
如果获批的上游路由发生变化，该政策仍能保持面向客户的接口规范稳定，同时 Narwhal 保留审计每个已接受观测值所需的证据。
当前限制
- 汇率和换算结果仅供参考，不是可执行的交易商报价、结算值或官方定盘价。
- 当前汇率、货币换算和历史观测数据均已公开提供，波动率计算功能不公开提供。
- 如果选定汇率缺失、格式错误或不可用，请求会直接失败，不会估算该汇率，也不会将其静默省略。
- Basic 和 Pro 方案包含 99.5% 可用性 SLA，详见服务条款。Narwhal数据不构成金融、投资、法律或税务建议。