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.