ה-API של v1 מיושן לטובת v2, אבל ימשיך לעבוד.

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

שערים עדכניים

קבלו את השערים של יום העסקים האחרון, שמתעדכנים מדי יום בסביבות 16:00 לפי שעון מרכז אירופה (CET).

curl https://api.frankfurter.dev/v1/latest

שנו את מטבע הבסיס באמצעות הפרמטר base. ברירת המחדל היא EUR.

curl https://api.frankfurter.dev/v1/latest?base=USD

הגבילו את התגובה למטבעות יעד מסוימים.

curl https://api.frankfurter.dev/v1/latest?symbols=CHF,GBP

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

קבלו שערים לתאריך מסוים.

curl https://api.frankfurter.dev/v1/1999-01-04

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

curl https://api.frankfurter.dev/v1/1999-01-04?base=USD&symbols=EUR

שימו לב: Frankfurter שומר תאריכים לפי UTC, כך שבאזור זמן אחר ייתכן שתשאלו על תאריך קלנדרי שונה מזה שציפיתם לו. השערים של היום עדיין יכולים להשתנות אם יתפרסמו שערים חדשים.

נתוני סדרות עתיות

קבלו שערים לאורך תקופה.

curl https://api.frankfurter.dev/v1/2000-01-01..2000-12-31

קבלו שערים עד היום.

curl https://api.frankfurter.dev/v1/2024-01-01..

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

curl https://api.frankfurter.dev/v1/2024-01-01..?symbols=USD

מטבעות זמינים

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

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

המרת מטבעות

קבלו את השער ובצעו את ההמרה בקוד שלכם.

function convert(from, to, amount) {
  fetch(`https://api.frankfurter.dev/v1/latest?base=${from}&symbols=${to}`)
    .then((resp) => resp.json())
    .then((data) => {
      const convertedAmount = (amount * data.rates[to]).toFixed(2);
      alert(`${amount} ${from} = ${convertedAmount} ${to}`);
    });
  }

convert("EUR", "USD", 10);