Python
SDK не нужен. Frankfurter работает поверх обычного HTTPS и возвращает плоский JSON, поэтому хватит 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.
Безопасные денежные вычисления
Числа с плавающей точкой годятся для отображения, но не для учёта. Разбирайте курсы как Decimal, передав parse_float в json.loads:
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()
Асинхронность
В асинхронном веб-приложении используйте 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.