JavaScript
אין צורך ב-SDK. fetch מגיעה עם כל דפדפן, Node, Deno, Bun
וסביבת edge. ה-CORS פתוח ואין מפתח שיכול לדלוף, כך שאפשר לקרוא ל-API
ישירות מקוד הלקוח.
התחלה מהירה
קבלו שער והמירו:
const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const data = await res.json();
const total = 100 * data.rate;
התגובה היא אובייקט שטוח אחד:
{"date": "2026-07-17", "base": "USD", "quote": "EUR", "rate": 0.8739}.
fetch מסתיימת בהצלחה גם בשגיאות HTTP, אז בדקו את res.ok;
קוד מטבע לא תקין מחזיר 422 עם הודעת JSON.
עיצוב עם Intl
אל תמקמו סמלי מטבע ידנית. Intl.NumberFormat מכירה את
הסמל, את מיקומו ואת מספר הספרות העשרוניות של כל מטבע, בכל
שפה ואזור:
const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const { rate } = await res.json();
const eur = new Intl.NumberFormat("en", {
style: "currency",
currency: "EUR",
});
eur.format(100 * rate); // "€87.39"
סמלים וספרות עשרוניות
אין צורך לצרף טבלת מטא-נתונים ליחידות משנה או לסמלים. שאלו את המעצב:
const yen = new Intl.NumberFormat("en", {
style: "currency",
currency: "JPY",
});
yen.resolvedOptions().maximumFractionDigits; // 0, the yen has no subunits
yen.formatToParts(1).find((part) => part.type === "currency").value; // "¥"
עיינו בכל המטבעות ש-Frankfurter מספק, עם הקודים והסמלים שלהם.
כמה מטבעות בבת אחת
/v2/rates מחזיר מערך שטוח, שורה אחת לכל מטבע יעד. הפכו אותו
לאובייקט חיפוש עם Object.fromEntries. השמיטו את quotes
כדי לקבל את כל המטבעות.
const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rates?base=usd"es=eur,gbp,jpy`);
const rows = await res.json();
const rates = Object.fromEntries(rows.map((row) => [row.quote, row.rate]));
// { EUR: 0.8739, GBP: 0.74388, JPY: 162.33 }
קיבוע מקור רשמי
כברירת מחדל מקבלים את השקלול של כל המקורות. הוסיפו
providers כדי לקבע רשות אחת בשמה, וזה חשוב כשתחום שיפוט מחייב
את השער שמפרסם הבנק המרכזי שלו, כמו שער הייחוס של ה-ECB למע"מ באיחוד
האירופי.
const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rate/usd/eur?providers=ecb`);
עיינו בכל המקורות. מקור מקובע פועל לפי לוח הפרסום שלו, כך שהשער העדכני שלו עשוי לפגר ביום אחד אחרי השער המשוקלל העדכני.
נסו בשידור חי
הרכיבו שאילתות וראו תגובות בלי לצאת מהדפדפן, ב-Playground.