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.
חישובים בטוחים לכסף
מספרי 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.