货币汇率 API：开发者指南

货币 API、汇率 API、FX API 和外汇 API 的含义有重叠。先明确应用要完成的任务，再核对响应结构、来源、时效、历史和限制。

货币汇率 API 能做什么

API 接收 USD、EUR、JPY 等代码，并返回汇率或换算金额。常见功能包括最新汇率、金额换算、历史日期和时间序列。

发送第一个汇率请求

此请求以 USD 为基础货币获取 EUR 和 GBP。无需密钥即可试用，创建凭据前可先检查响应。

curl "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP"

请同时读取 rates、source、market_session、timestamp 和 data_updated_at。数值用于计算，元数据说明来源和观测时间。

货币 API、汇率 API、FX API 与外汇 API

这些名称没有统一标准。外汇一词可能暗示交易，但只有接口契约能说明返回的是指示性中间价、买卖价还是可执行报价。

理解基础货币和报价货币

在 USD/EUR 中，USD 是基础货币，EUR 是报价货币。0.84 表示一美元对应 0.84 欧元。应保存两个货币代码。

从服务器端调用 API

生产环境中应把密钥留在服务器，设置超时，拒绝失败响应，并按功能所需时效缓存成功结果。

const response = await fetch(
  "https://api.exchangerate.dev/v1/latest/USD?symbols=EUR,GBP",
  {
    headers: {
      Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}`,
    },
    signal: AbortSignal.timeout(5000),
  },
);

if (!response.ok) {
  throw new Error(`exchange_rate_api_${response.status}`);
}

const snapshot = await response.json();
console.log(snapshot.rates.EUR, snapshot.data_updated_at);

按应用所需证据选择 API

• 确认具体货币和货币对。
• 区分每日参考值和日内观测值。
• 检查历史起始日期、间隔和缺口。
• 优先选择明确提供来源、时间和推导方式的服务。
• 上线前设计配额、缓存、重试和失败处理。
• 将指示性汇率与结算报价分开。

避免常见集成错误

不要在浏览器暴露密钥，不要用零替代刷新失败，也不要给旧数据写入新时间。保留最后一次成功观测及原时间，并标明过期状态。

FX API、外汇 API 与货币 API 的区别