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