浏览全部文档

历史外汇观测数据现已上线

可通过 REST 和 MCP 获取分页的历史汇率观测值,其中包含实际日期,但货币覆盖较为稀疏。

FX 现在通过同一个 Narwhal 密钥和额度提供当前汇率、安全的小数换算及历史观测值。

可通过 REST 和 MCP 使用

REST 操作是 GET /v1/fx/rates/{base}/observations。对应的 MCP 工具为 fx_get_rate_history。两者返回相同的结构,并从共享月度额度中扣除一次请求。

打开 历史 FX API 参考 用于参数、示例、错误和覆盖范围限制。

完整历史回填使用有界分页

调用方选择基准货币、货币列表和包含起止日期的日期范围。每页最多包含 366 个日期。不透明游标会在相同的筛选条件绑定请求中推进,直到回填完成。

缺失日期仍保持缺失

历史响应仅包含真实存储的观测日期。Narwhal不会创建周末或假日行,也不会将每周货币值向前填充到每日日期中。某个日期可能确实只包含所请求货币的一个子集。

公共响应保持精简

每条公开记录都包含日期、货币和字符串格式的小数汇率。提供方身份、路由、许可证、推导过程和内部审计字段不会出现在客户响应中。该 外汇数据方法说明 解释了该政策和历史数据限制。