تصفّح التوثيق كاملًا

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

معنى السعر وحداثته وسجله وتحويله ومصادره وحدوده.

تنشر Narwhal أسعار صرف إرشادية حالية، وتتيح تحويلًا يحافظ على الدقة العشرية ومشاهدات تاريخية عبر مواصفات متطابقة في REST وMCP. وتوضح اتجاه سعر الصرف ودلالات الوقت بدلًا من عرض رقم بلا سياق.

يتضمن السجل تواريخ مشاهدات فعلية

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

قد تتوفر في تاريخ معين بيانات لبعض العملات المطلوبة فقط. وهذا متوقع عندما تختلف دورية النشر أو التغطية التاريخية بينها. وتعيد الواجهة السلسلة التاريخية المقبولة حاليًا، لا جميع نسخها المنشورة سابقًا.

سعر الصرف يبيّن ما يعادل وحدة واحدة من العملة الأساسية بعملة التسعير

عندما تكون العملة الأساسية USD ويُعاد لعملة EUR معدل 0.92، يساوي الدولار الأمريكي الواحد 0.92 يورو. وتُعاد أسعار الصرف كسلاسل نصية لأعداد عشرية، والعملات المحددة كسجلات صريحة بدلًا من مفاتيح ديناميكية لكائنات.

تبقى التحديثات والحداثة ظاهرة

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

لكل سعر timestamp و stale الحالة. market_session التقارير open, weekend، أو interbank_closed. في عطلات نهاية الأسبوع وفترات إغلاق السوق، قد تظل أحدث مشاهدة مقبولة متاحة بطابعها الزمني الأصلي ومعلومات دقيقة عن جلسة التداول المرتبطة بها.

يستخدم التحويل سعرًا محددًا واحدًا

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

مزودو البيانات المرخصون والمعتمدون

يستخدم Narwhal مزودين مرخصين أو معتمدين بخلاف ذلك، ويحافظ على هوية المزود وسجلات التوجيه والترخيص وتفاصيل الاشتقاق في سجل التدقيق الداخلي. ولا تُدرج حقول المصدر التشغيلية هذه عمدًا في استجابة السعر العامة.

تحافظ هذه السياسة على ثبات المواصفات المقدمة للعميل إذا تغيّر مسار معتمد للوصول إلى المصدر، مع احتفاظ Narwhal بالأدلة اللازمة لتدقيق كل مشاهدة مقبولة.

القيود الحالية

  • الأسعار والتحويلات إرشادية وليست عروض متعاملين قابلة للتنفيذ أو قيم تسوية أو تثبيتات رسمية.
  • أسعار الصرف الحالية والتحويل والمشاهدات التاريخية متاحة للجمهور. أما حسابات التقلب فليست كذلك.
  • إذا كان سعر الصرف المحدد مفقودًا أو غير سليم الصيغة أو غير متاح، يُرفض الطلب بدلًا من تقدير السعر أو حذفه دون إشعار.
  • تتضمن خطتا Basic وPro اتفاقية مستوى خدمة بتوفر 99.5%؛ راجع الشروط. وبيانات Narwhal ليست نصيحة مالية أو استثمارية أو قانونية أو ضريبية.

اطّلع على الواجهة المتاحة حاليًا: واجهة API لأسعار الصرف أو أرسل طلبًا باتباع البدء السريع.