Frankfurter הוא API חינמי לשערי חליפין של 219 מטבעות ו-39 נכסים נוספים מ-112 בנקים מרכזיים ומקורות רשמיים. השערים מתעדכנים במהלך היום, וההיסטוריה היומית מגיעה עד 1948.

ה-API הציבורי זמין בכתובת api.frankfurter.dev. אין צורך במפתח API. הפרויקט בקוד פתוח, כך שאפשר גם לארח אותו בעצמכם ולקבל שליטה מלאה.

אלה שערי ייחוס, לא ציטוטי שוק בזמן אמת. כל מקור מפרסם אותם פעם אחת או כמה פעמים ביום.

עובדים עם סוכן AI? הפנו אותו אל llms.txt, או הוסיפו את שרת ה-MCP.

שערים

קבלו את שערי החליפין העדכניים.

curl https://api.frankfurter.dev/v2/rates

שנו את מטבע הבסיס באמצעות base.

curl https://api.frankfurter.dev/v2/rates?base=usd

סננו את מטבעות היעד באמצעות quotes.

curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp

שערים היסטוריים

חפשו שערים לתאריך מסוים.

curl https://api.frankfurter.dev/v2/rates?date=1999-01-04

סדרות עתיות

קבלו שערים לאורך תקופה באמצעות from ו-to.

curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&quotes=usd

טיפ: צמצום מספר המטבעות שומר על תגובות קטנות. לטווחי תאריכים גדולים, בקשו NDJSON כדי לקבל את התוצאות בזרימה, שורה אחר שורה.

קיבוץ

הקטינו את הרזולוציה של סדרה עתית באמצעות group. נתמכים week ו-month.

curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month

סינון לפי מקור

הגבילו את התוצאות למקורות מסוימים באמצעות providers.

curl https://api.frankfurter.dev/v2/rates?providers=ecb

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

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

curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln&quotes=ars,ngn

ייחוס למקורות

הוסיפו expand=providers כדי לראות אילו מקורות תרמו לכל שער משוקלל.

curl https://api.frankfurter.dev/v2/rates?expand=providers

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

פלט CSV

השערים זמינים גם בפורמט CSV. הוסיפו .csv לנתיב או הגדירו את הכותרת Accept ל-text/csv.

curl https://api.frankfurter.dev/v2/rates.csv

פלט NDJSON

לתגובות גדולות, בקשו NDJSON (JSON מופרד בשורות חדשות) על ידי הגדרת הכותרת Accept ל-application/x-ndjson. כל שורה היא אובייקט JSON עצמאי, וזה שימושי להזרמת סדרות עתיות גדולות בלי לשמור את כל התגובה בזיכרון.

curl https://api.frankfurter.dev/v2/rates?from=2026-01-01

שער

קבלו את השער של צמד מטבעות אחד. אפשר להוסיף date או providers.

curl https://api.frankfurter.dev/v2/rate/eur/usd

מטבעות

קבלו את המטבעות הזמינים עם כיסוי המקורות שלהם.

curl https://api.frankfurter.dev/v2/currencies

כללו מטבעות היסטוריים באמצעות scope.

curl https://api.frankfurter.dev/v2/currencies?scope=all

מטבע

קבלו פרטים וכיסוי מקורות עבור מטבע אחד.

curl https://api.frankfurter.dev/v2/currency/eur

מקורות

הציגו את המקורות שעליהם מבוסס ה-API.

curl https://api.frankfurter.dev/v2/providers

קבלו פרטים על מקור אחד.

curl https://api.frankfurter.dev/v2/providers/ecb

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

שערים לפי מקור

שאלו שערים ישירות ממקור מסוים. נתמכים אותם פרמטרים כמו ב-/v2/rates וב-/v2/rate.

curl https://api.frankfurter.dev/v2/providers/ecb/rates

קבלו צמד מטבעות אחד מאותו מקור.

curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd

שלבו עם date, טווחי תאריכים (from ו-to) או קיבוץ. גם פורמטים כמו .csv ו-ndjson עובדים כאן.

curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15

המרה

אין נקודת קצה להמרה. קבלו את השער והמירו בכמה שורות קוד.

function convert(base, quote, amount) {
  const api = "https://api.frankfurter.dev";
  return fetch(`${api}/v2/rate/${base}/${quote}`)
    .then((r) => r.json())
    .then((d) => (amount * d.rate).toFixed(2));
}

convert("eur", "usd", 10).then((result) =>
  alert(`10 EUR = ${result} USD`)
);

שגיאות

ה-API מחזיר קודי סטטוס HTTP סטנדרטיים עם גוף JSON.

{
  "status": 422,
  "message": "invalid currency: ABC"
}
400
פרמטר לא תקין או בקשה פגומה.
404
המטבע, השער או המשאב לא נמצאו.
422
הבקשה הובנה, אבל אי אפשר לעבד אותה.

אירוח עצמי

אפשר לארח בעצמכם עם Docker. מדריך הפריסה מסביר את ההגדרה לסביבת ייצור ואת הגדרת מפתחות ה-API.

שאלות נפוצות

למי Frankfurter מתאים (ולמי לא)?
הוא מתאים לחיוב ב-SaaS, למסחר מקוון, לדיווח מס, למערכות ERP ולהנהלת חשבונות, ולמחקר אקדמי על סדרות היסטוריות שמגיעות עד 1948. הוא לא נבנה למסחר בזמן אמת, או למטבעות אקזוטיים עם תנודות פרועות במהלך היום.
האם ה-API חינמי לשימוש מסחרי?
כן. השערים המשוקללים הם חישוב של Frankfurter עצמו וחופשיים לשימוש. שאילתות ישירות לנקודות קצה של מקורות בודדים כפופות לתנאים של כל מקור.
האם אפשר לשמור שערים או לאחסן אותם במטמון במסד נתונים משלי?
כן. אנחנו ממליצים לשמור את התצפיות היומיות מקומית לצורכי מטמון או ניתוח היסטורי, כדי שהתעבורה ל-API תישאר קלה.
האם יש ל-API מגבלות קריאה?
אין מכסות. קצב הבקשות מוגבל כדי למנוע שימוש לרעה, אבל אין תקרות חודשיות או יומיות. לשימוש בנפח גבוה, שקלו לשמור תגובות במטמון, לארח בעצמכם או לשאול את מערכי הנתונים ישירות.
האם ה-API תומך ב-GraphQL?
לא. ה-REST API פשוט מספיק, ו-GraphQL היה מוסיף מורכבות בלי תועלת של ממש. הוא גם היה שובר את המטמון בקצה, שבזכותו ה-API מהיר. השתמשו בפרמטרים כמו base, quotes ו-from/to כדי לקבל בדיוק את הנתונים שאתם צריכים.
האם ה-API של v1 עומד להיסגר?
לא. ה-API של v1 מיושן לטובת v2, אבל נשאר זמין ללא הגבלת זמן. ראו את התיעוד של v1. לנתוני הבנק המרכזי האירופי, השתמשו ב-/v2/providers/ecb/rates.
מהי מדיניות הפרטיות של ה-API?
ה-API לא אוסף ולא מתעד מידע אישי, כתובות IP או כתובות URL של בקשות. המופע הציבורי פועל מאחורי Cloudflare לצורכי מטמון והגנה מפני DDoS, שמספק רק סטטיסטיקות תעבורה מצטברות.
האם צריך לציין את ה-API בתוויות הפרטיות של App Store או Google Play?
לא. מכיוון שהשאילתות אנונימיות ולא נשמרים יומני בקשות, הבקשות נחשבות Data Not Collected (לא נאספים נתונים) לפי ההנחיות של Apple ו-Google Play.
איפה אפשר לדווח על באג או לשאול שאלה?
פתחו issue כדי לדווח על באג, לבקש פיצ'ר או להציע מקור חדש. השתמשו ב-Discussions כדי לשאול שאלות או לשתף ספרייה או כלי שבניתם עם Frankfurter.
עד כמה השערים מדויקים?
לצורכי ציות (מס והנהלת חשבונות), סננו לפי מקור מסוים כדי לקבל שערי ייחוס רשמיים. לשימוש כללי, השערים המשוקללים שמוגדרים כברירת מחדל עובדים היטב, אם כי הספרות העשרוניות האחרונות עשויות להשתנות כשמגיעים נתונים חדשים.
האם השערים הם שערי אמצע, קנייה או מכירה?
ה-API מחזיר שערי אמצע השוק. כשמקור מפרסם שערי קנייה ומכירה במקום שער ייחוס, Frankfurter שומר את שניהם ומחשב את נקודת האמצע.
האם כל שערי החליפין יומיים?
כמעט כולם. חלק מהמקורות מספקים תצפיות שבועיות, חודשיות או רבעוניות. מקורות אלה לא נכללים בשער המשוקלל. שאלו אותם ישירות באמצעות המסנן providers.
יש לכם שערים של מתכות יקרות או קריפטו?
כן. כמה בנקים מרכזיים מפרסמים שערים יומיים לזהב (XAU), לכסף (XAG), לפלטינה (XPT) ולפלדיום (XPD) לאונקיה טרויה. בקריפטו, אנחנו מגבילים את הרשימה למטבעות עם חוזים עתידיים ב-CME או עם CME CF Reference Rate (כמו BTC, ETH, SOL ו-XRP), ובנוסף USDT ו-USDC. רק מקורות מעטים מכסים קריפטו, ולכן הכיסוי דל.
למה לחלק מהמטבעות הישנים והחדשים יש תאריכים חופפים?
חלק מהמקורות מקדימים את התאריכים של מטבעות חלופיים לתקופת המטבע הישן (למשל, TRL מסתיים ב-2010 בעוד ש-TRY מתחיל ב-1996). אנחנו רושמים את נתוני המקורות כפי שהם, ומסננים חפיפות רק בעת השקלול.
למה Frankfurter?
כי מקור הנתונים המקורי שלנו הוא
European Central Bank