Frankfurter 汇率与货币 API
Frankfurter 是免费汇率 API,提供来自 112 家中央银行与官方机构的 219 种货币及其他 39 种资产的汇率。汇率全天持续更新。每日数据可追溯至 1948 年。
公共 API 地址为 api.frankfurter.dev,无需 API 密钥。项目完全开源,你也可以自行部署,完全掌控服务。
这些是参考汇率,而非实时市场报价。各数据源每天发布一次或数次。
正在使用 AI 智能体?让它读取 llms.txt,或添加 MCP 服务器。
汇率
获取最新汇率。
curl https://api.frankfurter.dev/v2/rates
使用 base 更改基准货币。
curl https://api.frankfurter.dev/v2/rates?base=usd
使用 quotes 筛选目标货币。
curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp
历史汇率
查询指定日期的汇率。
curl https://api.frankfurter.dev/v2/rates?date=1999-01-04
时间序列
使用 from 和 to 获取一段时间内的汇率。
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01"es=usd
提示:只请求需要的货币可以显著减小响应体积。查询较长的日期范围时,建议请求 NDJSON,逐行流式读取结果。
分组汇总
使用 group 对时间序列降采样,支持 week 和 month。
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month
按数据源筛选
使用 providers 限定特定数据源。
curl https://api.frankfurter.dev/v2/rates?providers=ecb
默认返回综合所有数据源计算出的汇率。如需特定机构的汇率,可使用 providers 筛选,或通过数据源专属路由直接查询。
部分数据源会发布多个数据集,例如 NBP 的每日和每周汇率表。数据源代码选取其默认数据集,数据集代码只选取该数据集。
curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln"es=ars,ngn
数据源标注
添加 expand=providers,即可查看每个综合汇率由哪些数据源参与计算。
curl https://api.frankfurter.dev/v2/rates?expand=providers
每行数据会新增一个 providers 数组,列出参与计算的数据源代码。实行盯住汇率的货币不含此字段,因为其汇率来自盯住关系,而非数据源。
CSV 输出
汇率也提供 CSV 格式。在路径后加上 .csv,或将 Accept 请求头设为 text/csv。
curl https://api.frankfurter.dev/v2/rates.csv
NDJSON 输出
处理大型响应时,可将 Accept 请求头设为 application/x-ndjson,请求
NDJSON(换行分隔的 JSON)。每一行都是独立的 JSON 对象,适合在不缓冲整个响应的情况下流式读取大型时间序列。
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01
单一汇率
获取单个货币对的汇率,可选择添加 date 或 providers。
curl https://api.frankfurter.dev/v2/rate/eur/usd
货币列表
获取可用货币及其数据源覆盖范围。
curl https://api.frankfurter.dev/v2/currencies
使用 scope 包含已停用的历史货币。
curl https://api.frankfurter.dev/v2/currencies?scope=all
单一货币
获取单个货币的详细信息与数据源覆盖范围。
curl https://api.frankfurter.dev/v2/currency/eur
数据源
列出 API 背后的所有数据源。
curl https://api.frankfurter.dev/v2/providers
获取单个数据源的详细信息。
curl https://api.frankfurter.dev/v2/providers/ecb
每个数据源都会列出其数据集,各自附有日期范围、发布时间表和货币。
按数据源查询汇率
直接从特定数据源查询汇率,支持与 /v2/rates 和 /v2/rate 相同的参数。
curl https://api.frankfurter.dev/v2/providers/ecb/rates
从该数据源获取单个货币对的汇率。
curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd
可搭配 date、日期范围(from 和 to)或分组汇总使用,同样支持 .csv 和 ndjson 等格式。
curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15
金额换算
API 没有单独的换算端点。先获取汇率,再用几行代码完成换算。
function convert(base, quote, amount) {
const api = "https://api.frankfurter.dev";
return fetch(`${api}/v2/rate/${base}/${quote}`)
.then((r) => r.json())
.then((d) => (amount * d.rate).toFixed(2));
}
convert("eur", "usd", 10).then((result) =>
alert(`10 EUR = ${result} USD`)
);
错误处理
API 返回标准 HTTP 状态码和 JSON 响应体。
{
"status": 422,
"message": "invalid currency: ABC"
}
400- 参数无效或请求格式错误。
404- 找不到货币、汇率或资源。
422- 请求格式正确,但无法处理。
自行部署
你可以使用 Docker 自行部署。生产环境配置和 API 密钥设置请参阅 Deploy 指南。
常见问题
- Frankfurter 适合哪些场景(又不适合哪些场景)?
- 适合 SaaS 计费、电子商务、税务申报、ERP 与会计系统,以及使用可追溯至 1948 年的历史序列开展学术研究。不适合实时交易,也不适合日内剧烈波动的冷门货币。
- API 可以免费用于商业用途吗?
- 可以。综合汇率由 Frankfurter 自行计算,可免费使用。直接查询单个数据源的端点时,仍须遵守该数据源的使用条款。
- 可以把汇率存储或缓存到自己的数据库吗?
- 可以。我们鼓励在本地存储每日数据,用于缓存或历史分析,以减轻 API 流量。
- API 有调用次数限制吗?
- 没有配额。为防止滥用,请求设有速率限制,但没有每日或每月上限。如有大量调用需求,建议缓存响应、自行部署,或直接查询数据集。
- API 支持 GraphQL 吗?
-
不支持。REST API 已足够简单,引入 GraphQL 只会增加复杂度而收效甚微,还会破坏让 API 保持高速的边缘缓存。使用
base、quotes和from/to等查询参数,即可精确获取所需数据。 - v1 API 会停用吗?
- 不会。v1 API 已标记为 deprecated,由 v2 取代,但会无限期继续提供。详见 v1 文档。如需欧洲中央银行数据,请使用 /v2/providers/ecb/rates。
- API 的隐私政策是什么?
- API 不收集也不记录个人数据、IP 地址或请求 URL。公共实例通过 Cloudflare 提供缓存和 DDoS 防护,Cloudflare 只提供汇总的流量统计。
- 需要在 App Store 或 Google Play 的隐私标签中声明此 API 吗?
- 不需要。由于查询是匿名的,且不保留任何请求日志,按照 Apple 和 Google Play 的规范,这些请求属于“未收集数据”(Data Not Collected)。
- 在哪里报告错误或提问?
- 报告错误、提出功能需求或建议新增数据源,请创建 Issue。提问或分享你基于 Frankfurter 开发的库与工具,请使用 Discussions。
- 汇率有多准确?
- 如有合规需求(税务与会计),请筛选特定数据源以获取官方参考汇率。一般用途使用默认的综合汇率即可,但随着新数据录入,最后几位小数可能会有变动。
- 汇率是中间价、买入价还是卖出价?
- API 返回市场中间价。当数据源发布的是买入价和卖出价而不是参考汇率时,Frankfurter 会同时保存两者并计算中间值。
- 所有汇率都是每日数据吗?
-
几乎都是。部分数据源提供每周、每月或每季度数据,这些数据源不参与综合汇率计算。请使用
providers筛选直接查询。 - 有贵金属或加密资产的汇率吗?
-
有。多家中央银行每天发布黄金(
XAU)、白银(XAG)、铂金(XPT)和钯金(XPD)每金衡盎司的价格。加密资产方面,我们只收录有 CME 期货或 CME CF Reference Rate 的币种(如BTC、ETH、SOL和XRP),外加USDT和USDC。提供加密资产的数据源不多,因此覆盖有限。 - 为什么部分新旧货币的日期会重叠?
-
部分数据源会把替代货币的汇率回溯到旧货币的流通期间(例如
TRL于 2010 年结束,而TRY自 1996 年起就有数据)。我们按原样记录数据源的数据,只在计算综合汇率时过滤重叠部分。 - 为什么叫 Frankfurter?
-
因为我们最初的数据源是