Python
有疑问或遇到问题?欢迎在 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。