有疑问或遇到问题?欢迎在 GitHub Discussions 发帖。

你不需要 SDK。所有浏览器以及 Node、Deno、Bun 和边缘运行时都内置了 fetch。CORS 完全开放,也没有可能泄露的密钥,因此可以直接在客户端代码中调用 API。

快速开始

获取汇率并换算:

const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const data = await res.json();
const total = 100 * data.rate;

响应是一个扁平对象:{"date": "2026-07-17", "base": "USD", "quote": "EUR", "rate": 0.8739}。fetch 在 HTTP 错误时也会 resolve,因此请检查 res.ok;无效的货币代码会返回 422 和一条 JSON 消息。

用 Intl 格式化

不要手动放置货币符号。Intl.NumberFormat 知道每种货币在每种语言环境下的符号、符号位置和小数位数:

const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const { rate } = await res.json();

const eur = new Intl.NumberFormat("en", {
  style: "currency",
  currency: "EUR",
});
eur.format(100 * rate); // "€87.39"

符号与小数位数

无需自带辅币单位或符号的元数据表,直接问格式化器:

const yen = new Intl.NumberFormat("en", {
  style: "currency",
  currency: "JPY",
});

yen.resolvedOptions().maximumFractionDigits; // 0, the yen has no subunits
yen.formatToParts(1).find((part) => part.type === "currency").value; // "¥"

浏览 Frankfurter 提供的所有货币及其代码和符号。

一次获取多种货币

/v2/rates 返回一个扁平数组,每种目标货币一行。用 Object.fromEntries 把它转换成查找表。省略 quotes 即可获取所有货币。

const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rates?base=usd&quotes=eur,gbp,jpy`);
const rows = await res.json();

const rates = Object.fromEntries(rows.map((row) => [row.quote, row.rate]));
// { EUR: 0.8739, GBP: 0.74388, JPY: 162.33 }

固定官方数据源

默认情况下,你获得的是综合所有数据源的汇率。添加 providers 即可固定使用某一家指定的权威机构;当某个司法辖区要求使用其中央银行公布的汇率时(例如欧盟增值税使用的欧洲央行参考汇率),这一点很重要。

const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rate/usd/eur?providers=ecb`);

浏览所有数据源。固定的数据源按自己的发布时间表更新,因此其最新汇率可能比综合汇率晚一天。

在线试用

在 Playground 中编写查询并查看响应,无需离开浏览器。