Є запитання чи проблеми? Пишіть у GitHub Discussions.

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.