منهجية بيانات أسعار الصرف

1. فئات المصادر

يصف الحقل العام source فئة بيانات، وليس مزودًا. تشير live إلى بيانات استرشادية للسوق الفورية يمكن تحديثها على فترات قصيرة خلال أسبوع التداول بين البنوك. وتشير ecb_daily إلى سعر مرجعي من البنك المركزي الأوروبي، يُنشر عادةً مرة واحدة في كل يوم عمل. وتخزن market_daily سعر الإغلاق اليومي من تغذية بيانات السوق للعملات التي لا يتوفر لها سعر مرجعي محدد من ECB.

تتضمن الاستجابة متعددة العملات خريطة sources لكل عملة مسعّرة. ويتخذ حقل source في مستواها الأعلى نهجًا متحفظًا: فهو يعرض فئة البيانات الأقل حداثة الموجودة في تلك الاستجابة.

المرجع: أسعار صرف اليورو المرجعية لدى ECB.

2. الوقت وحالة السوق

يشير data_updated_at إلى آخر وقت كُتبت فيه القراءة الأساسية. ويشير timestamp إلى وقت إنشاء استجابة API. استخدم الأول لحساب عمر البيانات، والثاني لتدقيق توقيت الطلب.

تكون قيمة market_session هي open خلال أسبوع التداول بين البنوك، أو weekend بعد إغلاق الجمعة الساعة 17:00 بتوقيت نيويورك وحتى الأحد الساعة 17:00 بتوقيت نيويورك، أو interbank_closed عند وجود إغلاق معروف خارج عطلة نهاية الأسبوع. قد تتضمن استجابة عطلة نهاية الأسبوع آخر قراءة من أسبوع التداول؛ ولا يعني التصنيف وجود سعر جديد خلال عطلة نهاية الأسبوع.

3. تغيير عملة الأساس واشتقاق الأسعار المتقاطعة

تُوحّد الأسعار بحيث يمكن لمستدعي API طلب أي عملة أساس مدعومة. وعندما لا يُرصد زوج مباشرةً، تحسبه API بالتثليث عبر أزواج العملات الوسيطة المتاحة. تُحدد القيم المشتقة في derived_symbols؛ كما تعرض استجابات الزوج الواحد derived وحدّ derivation_bps_max عند انطباقه.

يرث السعر المتقاطع المصدر الأقل حداثة من أزواج العملات التي يتكون منها. ينبغي للتطبيقات التي لا يمكنها قبول سعر مشتق فحص حقول الاشتقاق بدلًا من الاستنتاج من زوج العملات.

4. القراءات التاريخية

يجمع السجل اليومي بين الأسعار المرجعية المحددة وأسعار إغلاق السوق. تمتد بيانات العملات الرئيسية إلى عام 1999؛ وتستخدم نحو 30 عملة أسعار ECB المرجعية المحددة، بينما تستخدم العملات الـ113 الأخرى أسعار إغلاق السوق، وتختلف تواريخ بدء البيانات حسب الزوج. في عطلة نهاية الأسبوع أو العطلات الرسمية التي لا يصدر فيها سعر مرجعي جديد، قد تُرحّل قراءة سابقة وتُوسم بـ is_forward_filled: true. لا تختلق API سعرًا مرجعيًا لم يُنشر.

5. التحقق والنشر

تُوحّد معرّفات العملات إلى رموز بأحرف كبيرة على نمط ISO قبل التسعير.
ترافق حقول المصدر ووقت التحديث القراءة، بدلًا من أن يستنتجها العميل.
عند غياب القراءات المباشرة أو تقادمها أكثر من اللازم، يُستخدم بدلًا منها تصنيف مرجعي يومي متاح، ولا تُصنّف على أنها مباشرة.
تستخدم جميع الخطط المصدر نفسه؛ ويتلقى مستخدمو Free ومستدعو API دون مفتاح الأسعار المباشرة متأخرة 15 دقيقة.
يجب أن تتضمن الأبحاث المنشورة فترة القياس، وعدد العينات، والطريقة، والقيود.

6. القيود

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

7. معيار قياس حداثة البيانات

ننشر البروتوكول قبل نشر أي ترتيب. يحدد المعيار القابل لإعادة الإنتاج لقياس حداثة بيانات واجهات API لأسعار الصرف فترة الرصد، ومتطلبات الطوابع الزمنية، والمقاييس، والاستبعادات، والحد الأدنى لحجم العينة. ولا يتضمن بروتوكوله القابل للقراءة آليًا حاليًا أي نتائج للمزودين؛ ولن تُضاف النتائج إلا بعد استيفاء الحد المعلن للأدلة.

سجل المراجعات

1.1 · 9 أكتوبر 2026: توضيح التأخير في Free وأسعار إغلاق السوق اليومية.

1.0 · 16 يوليو 2026: المنهجية العامة الأولية، ودلالات المصادر، وقواعد جلسات السوق، وسياسة الاشتقاق، وكيفية التعامل مع البيانات التاريخية، والقيود، ومعيار نشر نتائج القياس المقارن.

التصحيحات: hello@exchangerate.dev