汇率 API

160+ 种货币的每日参考汇率与换算

数据来源：ExchangeRate-API (open.er-api.com)

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

以指定货币为基准的全部汇率

GET /api/fx/rates

请求参数

  • base：基准货币（ISO 4217 三位代码），示例 CNY
  • symbols：只返回这些货币，逗号分隔，示例 CNY,EUR,JPY

返回字段

  • base（string）：基准货币代码（ISO 4217 大写三位，如 USD）
  • updatedAt（string|null）：上游汇率的最近更新时间（ISO 8601，UTC，如 2024-09-23T00:02:31.000Z），上游每日更新一次；上游未提供时为 null。注意与响应外层的 updatedAt（本服务缓存写入时间）不是一回事
  • nextUpdateAt（string|null）：上游预计下次更新汇率的时间（ISO 8601，UTC）；上游未提供时为 null
  • rates（object）：汇率表，键为货币代码（ISO 4217 大写三位），值见 rates.*。传了 symbols 时只保留其中上游支持的货币，不支持的代码会被直接忽略（不报错），因此可能比请求的少
  • rates.*（number）：1 单位基准货币可兑换的该货币数量（未取整）。如 base=USD 时 rates.CNY = 7.0512 表示 1 美元 = 7.0512 元人民币；汇率表里基准货币自身的值为 1

货币换算

GET /api/fx/convert

请求参数

  • from（必填）：源货币，示例 USD
  • to（必填）：目标货币，示例 CNY
  • amount：金额，示例 100

返回字段

  • from（string）：源货币代码（ISO 4217 大写三位）
  • to（string）：目标货币代码（ISO 4217 大写三位）
  • amount（number）：待换算的金额，单位为源货币（即请求参数 amount）
  • rate（number）：汇率：1 单位源货币可兑换的目标货币数量（如 from=USD、to=CNY 时 7.0512 表示 1 美元 = 7.0512 元人民币）
  • result（number）：换算结果，单位为目标货币，= amount × rate，四舍五入保留 6 位小数
  • updatedAt（string|null）：所用汇率的上游更新时间（ISO 8601，UTC）；上游未提供时为 null。与响应外层的 updatedAt（本服务缓存写入时间）不是一回事