浏览全部文档

FX API 参考

通过 REST 和 MCP 获取当前汇率、进行货币换算和查询历史数据。

三个操作均已上线。它们使用同一个 Narwhal 密钥,并共用同一账户的配额。

三个操作

操作REST 路径MCP 工具
当前汇率/v1/fx/rates/{base}fx_get_rates
货币换算/v1/fx/convertfx_convert_currency
历史汇率/v1/fx/rates/{base}/observationsfx_get_rate_history

通用规则

  • 每单位基准货币可兑换的报价货币数量等于返回的汇率。
  • 汇率和金额以十进制字符串表示。
  • 当前汇率保留各自的时间戳和过期状态。
  • REST 和 MCP 使用相同的数据并共用配额。
  • 错误采用 Narwhal 通用的错误响应格式。

覆盖范围

当前汇率查询接受支持范围内的现行流通 ISO 4217 货币。历史数据的起始日期因货币而异,并保留实际存在的数据缺口。

查看外汇覆盖范围 · 阅读方法说明