لديك أسئلة أو مشكلات؟ اكتب في GitHub Discussions.

لا تحتاج إلى SDK. تأتي fetch مع كل متصفح وNode وDeno وBun وبيئات التشغيل على الحافة. وCORS مفتوح ولا يوجد مفتاح قد يتسرّب، لذا يمكنك استدعاء الواجهة مباشرة من كود العميل.

البدء السريع

احصل على سعر وحوّل المبلغ:

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&quotes=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 لتثبيت جهة واحدة بعينها، وهذا مهم حين تشترط جهة تنظيمية السعر الذي ينشره بنكها المركزي، مثل السعر المرجعي للبنك المركزي الأوروبي لضريبة القيمة المضافة في الاتحاد الأوروبي.

const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rate/usd/eur?providers=ecb`);

تصفّح جميع المصادر. يتبع المصدر المثبّت جدول نشره الخاص، لذا قد يتأخر أحدث أسعاره عن أحدث سعر مدمج بيوم.

جرّبها مباشرة

أنشئ الاستعلامات واطّلع على الاستجابات دون مغادرة المتصفح في Playground.