أسعار الصرف المرجعية للبنك المركزي الأوروبي، موضحة

حين تستدعي /v1/latest/USD وتحصل على source: ecb_daily، فأنت تقرأ سعر اليورو المرجعي الصادر عن البنك المركزي الأوروبي: يُنشر مرة واحدة في كل يوم عمل حوالي الساعة 16:00 بتوقيت وسط أوروبا، وهو مخصص للمرجعية والمعلومات لا للتعاملات. هذا هو أوثق رقم يومي لأزواج اليورو، لكنه لقطة واحدة — يستمر السوق في الحركة بعد الساعة 16:00 بتوقيت وسط أوروبا، ولا يتحدّث السعر الثابت حتى يوم العمل التالي.

ما هو السعر المرجعي للبنك المركزي الأوروبي

في كل يوم عمل، ينشر البنك المركزي الأوروبي مجموعة من أسعار صرف اليورو المرجعية. تُحسب هذه الأسعار حوالي الساعة 16:00 بتوقيت وسط أوروبا عبر عملية تشاور مع بنوك مركزية داخل المنظومة الأوروبية للبنوك المركزية وخارجها. تمثل الأسعار رقما توافقيا لمنتصف السوق في تلك اللحظة، وهي مخصصة للاستخدام المعلوماتي والمرجعي فقط، كما توضح وثائق البنك المركزي الأوروبي نفسه.

تُستخدم هذه الأسعار على نطاق واسع في العقود المالية والمحاسبة والتقارير الرقابية عبر الاتحاد الأوروبي، لأنها صادرة عن مؤسسة عامة وتُنشر وفق جدول ثابت وشفاف. حين ترى source: ecb_daily في رد الواجهة البرمجية، فهذا بالضبط ما تقرؤه.

ثلاث فئات مصادر في الواجهة البرمجية

كل رد من الواجهة البرمجية يحمل حقل source يخبرك من أي فئة بيانات جاء السعر. توجد ثلاث فئات:

الفئة الثالثة، fred_daily، تأتي من السلسلة اليومية للاحتياطي الفيدرالي الأمريكي، وهي الأكثر صلة بأزواج الدولار الأمريكي حيث ينشر الاحتياطي الفيدرالي أرقامه المرجعية الخاصة. تتبع وتيرة مشابهة لـecb_daily: مرة واحدة كل يوم عمل، مع فجوات في العطلات الرسمية الأمريكية.

قراءة رد مصدره البنك المركزي الأوروبي

اطلب أحدث الأسعار لأي عملة أساس وتحقق من source لتعرف ما تنظر إليه:

curl -s https://api.exchangerate.dev/v1/latest/EUR

{
  "result": "success",
  "base": "EUR",
  "source": "ecb_daily",
  "market_session": "open",
  "timestamp": "2026-06-19T14:05:33Z",
  "data_updated_at": "2026-06-19T14:00:00Z",
  "rates": {
    "USD": 1.14235,
    "GBP": 0.86781,
    "JPY": 184.320
  },
  "notice": "Indicative rates, not for settlement. Source: incl. ECB statistics."
}

يظهر حقلا توقيت في كل رد. data_updated_at هو وقت آخر كتابة للسعر الأساسي في مخزن البيانات. بالنسبة لـecb_daily سيكون هذا حوالي الساعة 16:00 بتوقيت وسط أوروبا في آخر يوم عمل. أما timestamp فهو وقت بناء الواجهة البرمجية للرد. إذا كنت تخزّن الردود مؤقتا، فـdata_updated_at هو الحقل الذي تتبعه لمعرفة القِدَم.

ذلك الطلب الأول يعمل دون مفتاح. حين ينتقل الاستدعاء إلى مهمة مجدولة أو تطبيق، أنشئ مفتاحا مجانيا لحصة مرتبطة بحسابك، واحتفظ به على الخادم.

بين التثبيتات وعطلات نهاية الأسبوع والتعبئة الاستباقية

تثبيت البنك المركزي الأوروبي لقطة واحدة يوميا. بين نشر الساعة ~16:00 بتوقيت وسط أوروبا وتثبيت يوم العمل التالي، لا تتحدّث بيانات ecb_daily — أي حركة سوقية خلال اليوم أو طوال الليل لا تُسجَّل. كما لا ينشر البنك المركزي الأوروبي في عطلات نهاية الأسبوع أو العطلات الرسمية، فيعيد طلب يوم السبت أو الأحد تثبيت يوم الجمعة. تعالج الواجهة البرمجية تواريخ عدم النشر بحقل is_forward_filled:

curl -s https://api.exchangerate.dev/v1/2026-06-13/USD \
  -H "Authorization: Bearer exr_live_..."

{
  "result": "success",
  "base": "USD",
  "source": "fred_daily",
  "market_session": "weekend",
  "is_forward_filled": true,
  "rates": {
    "EUR": 0.87531,
    "GBP": 0.75945,
    "JPY": 161.412
  }
}

حين تكون قيمة is_forward_filled هي true، فالسعر في الرد هو آخر قيمة منشورة منقولة من يوم العمل السابق. إنه ليس رصدا جديدا. لكثير من الاستخدامات (عرض سعر في عطلة نهاية الأسبوع، تعبئة رسم بياني) هذا مقبول. أما في المحاسبة أو مسارات التدقيق حيث تحتاج تسجيل ما إذا كان تثبيت فعلي قد وُجد في تاريخ معين، فعليك التحقق من هذه العلامة.

التحقق من source في Python

نمط شائع هو قراءة السعر والتفرّع بحسب source لتقرير طريقة عرضه:

import requests

API = "https://api.exchangerate.dev/v1"
KEY = "exr_live_..."

resp = requests.get(
    f"{API}/latest/USD",
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=10,
)
resp.raise_for_status()
data = resp.json()

rate = data["rates"]["EUR"]        # 0.87531
source = data["source"]            # ecb_daily
session = data["market_session"]   # open

if source == "ecb_daily":
    print(f"ECB reference rate as of last business day: {rate}")
elif source == "live":
    print(f"Indicative spot rate ({session}): {rate}")
else:
    print(f"Rate ({source}): {rate}")

السجل التاريخي منذ 1999

بدأ البنك المركزي الأوروبي سلسلة EXR عند إدخال اليورو. تعرض الواجهة البرمجية هذا السجل الكامل عبر المسار المؤرّخ /v1/{date}/{base} ومسار النطاق /v1/range. يعيد كلاهما is_forward_filled حيثما ينطبق. يمكنك سحب سلسلة زمنية لزوج عملات محدد عبر أي نافذة:

curl -s "https://api.exchangerate.dev/v1/range?base=EUR&symbols=USD&start_date=2026-06-10&end_date=2026-06-16" \
  -H "Authorization: Bearer exr_live_..."

لاحظ أسماء المعاملات: start_date وend_date (بصيغة snake_case)، وsymbols كسلسلة نصية مفصولة بفواصل. يعيد النطاق صفا واحدا لكل يوم عمل منشور، لكل منها source وis_forward_filled خاصان به؛ تواريخ عطلة نهاية الأسبوع غير مدرجة كصفوف.