Frankfurter API לשערי חליפין ומטבעות
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"es=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"es=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?
-
כי מקור הנתונים המקורי שלנו הוא