יש שאלות או בעיות? כתבו ב-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.

חישובים בטוחים לכסף

מספרי float טובים לתצוגה ושגויים להנהלת חשבונות. נתחו את השערים כ-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 מחזיר מערך שטוח, שורה אחת לכל מטבע יעד. הפכו אותו למילון חיפוש עם comprehension. השמיטו את 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 כדי לקבע רשות אחת בשמה, וזה חשוב כשתחום שיפוט מחייב את השער שמפרסם הבנק המרכזי שלו, כמו שער הייחוס של ה-ECB למע"מ באיחוד האירופי.

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

עיינו בכל המקורות. מקור מקובע פועל לפי לוח הפרסום שלו, כך שהשער העדכני שלו עשוי לפגר ביום אחד אחרי השער המשוקלל העדכני.

מנתחים סדרה?

לטווחי תאריכים, קיבוץ חודשי ותרשימים, נקודת הקצה של ה-CSV נטענת ישירות ל-DataFrame. ראו pandas.