الإصدار 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);