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

你不需要 SDK。Frankfurter 就是返回扁平 JSON 的普通 HTTPS 接口,用你已经在用的 HTTP 库就够了。无需 API 密钥,也无需账号。

快速开始

获取汇率并换算:

import requests

res = requests.get("https://api.frankfurter.dev/v2/rate/usd/eur")
data = res.json()
total = 100 * data["rate"]

响应是一个扁平对象:{"date": "2026-07-17", "base": "USD", "quote": "EUR", "rate": 0.8739}。无效的货币代码会返回 422 和一条 JSON 消息。

安全的金额计算

浮点数适合显示,但不适合会计。把 parse_float 传给 json.loads,将汇率解析为 Decimal:

from decimal import Decimal

import requests

res = requests.get("https://api.frankfurter.dev/v2/rate/usd/eur")
data = res.json(parse_float=Decimal)
total = Decimal("100") * data["rate"]

一次获取多种货币

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

res = requests.get(
    "https://api.frankfurter.dev/v2/rates",
    params={"base": "usd", "quotes": "eur,gbp,jpy"},
)
rates = {row["quote"]: row["rate"] for row in res.json()}

缓存不会变的数据

固定数据源的历史汇率不会改变,可以想缓存多久就缓存多久。综合汇率可能随新数据录入而变动,最新汇率会随数据源发布而变化(每个工作日最多几次),因此请为它们设置较短的 TTL。使用 requests-cache,一行代码即可实现缓存:

import requests_cache

session = requests_cache.CachedSession("frankfurter", expire_after=3600)
res = session.get("https://api.frankfurter.dev/v2/rate/usd/eur")
data = res.json()

异步

在异步 Web 应用中,使用 httpx:

import httpx

API = "https://api.frankfurter.dev"


async def rate(base, quote):
    async with httpx.AsyncClient(base_url=API) as client:
        res = await client.get(f"/v2/rate/{base}/{quote}")
        res.raise_for_status()
        return res.json()["rate"]

固定官方数据源

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

res = requests.get(
    "https://api.frankfurter.dev/v2/rate/usd/eur",
    params={"providers": "ecb"},
)
data = res.json()

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

需要分析时间序列?

对于日期范围、按月分组和图表,CSV 端点可以直接载入 DataFrame。参见 pandas。