التوثيق
سجل التغييرات
تحديثات المنتج والتوثيق من Narwhal API.
تابع تغييرات الموقع العام والتوثيق وتوفر API.
صفحات البيانات الاقتصادية
- أضفنا صفحات لكل دولة ومؤشراتها، مع رسوم بيانية تاريخية وتنزيلات CSV وعناصر قابلة للتضمين.
- أضفنا عرضًا لكل مؤشر عبر الدول، والتقويم الاقتصادي حسب الدولة والشهر، ومنحنيات العائد.
- تعيد صفحات تغطية الدول باللغة الإنجليزية الآن توجيه الزوار إلى صفحة بيانات كل دولة.
الأحداث وخطافات الويب
- أضفنا GET /v1/events وWebSocket على /v1/events/stream، مع مؤشرات لإعادة التشغيل.
- أضفنا وجهات لخطافات الويب مع تسليم موقّع مرة واحدة على الأقل، وسجل للتسليم وإمكانية إعادة التشغيل.
- أضفنا prediction.event.closed وprediction.event.settled إلى عائلة predictions.
تغطي FX الآن 144 عملة
- أضفنا 113 عملة إلى أسعار الصرف والسجل التاريخي والتحويل.
- تبقى طلبات العملات الـ31 السابقة دون تغيير.
السجل التاريخي لأسعار المعادن وFX
- أضفنا GET /v1/commodities/spot/{commodity}/{currency}/bars وcommodities_get_price_history للذهب والفضة والبلاتين والبلاديوم.
- أضفنا GET /v1/fx/rates/{base}/bars وfx_get_rate_bars لعملة واحدة مقابل USD.
- تستخدم الأعمدة فواصل 1m و5m و15m و1h و4h و1d. تغطي أعمدة الدقائق آخر 30 يومًا؛ وتبقى أعمدة الساعات والأيام دون حد زمني، ضمن نطاق السجل التاريخي في خطتك.
نتائج الأحداث المسوّاة في التوقعات
- أُضيف حقل للنتيجة إلى استجابات حدث التنبؤ وقائمة الأحداث والموضوع عبر REST وMCP. يُحذف الحقل حتى تتم تسوية الحدث.
- تعرض كل منصة final وsettled_at وamended_at وunavailable. وتسرد صفحات الأحداث أيضًا نتيجة كل سوق وقيمته.
- ترى خطة Free النتيجة من اليوم التالي (نهاية اليوم، 00:00 UTC). وترى خطتا Basic وPro النتيجة فور حصول Narwhal عليها.
- تشير الترويسة X-Narwhal-Results: unavailable إلى تعذّر قراءة النتائج المخزنة، ولذلك يُحذف result؛ حاول لاحقًا.
- يحمل البث وخطافات الويب الحالة فقط كما كان.
الأسعار المرجعية الشهرية للسلع وسجل الأسعار
- أُضيفت الأسعار المرجعية الشهرية إلى نقاط النهاية الحالية للسلاسل الفعلية، للاكتشاف والتفاصيل وأحدث الأسعار والمشاهدات. يستخدم REST وMCP معرّفات السلاسل نفسها.
- تشمل التغطية السلع الزراعية اللينة والزيوت والبذور الزيتية والمعادن والحبوب والطاقة والأسمدة والمنتجات الحرجية والماشية ومنتجات الألبان. جميع الأسعار بوحدة USD، مع الحفاظ على الوحدات والكميات المنشورة.
- أحدث شهر متاح هو سبتمبر 2026. تبدأ بعض السلاسل لاحقًا أو تكون قد انتهت. تعرض كل سلسلة تواريخ تغطيتها الخاصة.
- أُضيفت صفحة API للأسعار التاريخية للسلع، وأمثلة استجابات النحاس، والقائمة الكاملة لتغطية الأسعار المرجعية الشهرية.
أسعار التجزئة للبنزين والديزل في الولايات المتحدة
- أُضيفت أربع عمليات عبر REST وMCP ضمن /v1/commodities/physical/series لاكتشاف السلاسل وتفاصيلها وأحدث سعر والمشاهدات.
- أُضيفت 20 سلسلة أسبوعية للبنزين العادي وديزل الطرق رقم 2. تغطي كل منهما متوسط الولايات المتحدة وتسع مناطق، بوحدة USD لكل غالون أمريكي.
- يتضمن السجل 12 أسبوعًا من 20 يوليو إلى 5 أكتوبر 2026. تأتي التحديثات بعد مسح يوم الاثنين. تحتفظ الاستجابات بالتواريخ والأسعار كسلاسل نصية عشرية وتواريخ النشر التي تقبل null والمراجعات ونسب البيانات إلى مصدرها.
الأسعار المرجعية لخام WTI وخام برنت والنحاس
- أُضيفت أسعار WTI وBRENT بعملة USD لكل برميل وXCU بعملة USD لكل رطل إلى GET /v1/commodities/spot/{commodity}/{currency} وcommodities_get_spot_price.
- هذه أسعار مرجعية مشتقة من أسواق العقود الآجلة، وليست أسعارًا فورية لشحنات فعلية. حقول الاستجابة وعلامة stale لم تتغير.
- يتوفر سجل أسعار WTI وBRENT عبر GET /v1/commodities/spot/{commodity}/USD/bars وcommodities_get_price_history، بالفواصل الزمنية والقواعد نفسها المستخدمة للمعادن. يدعم النحاس أحدث سعر فقط.
إضافة أسعار البلاتين والبلاديوم الفورية
- أُضيفت أسعار XPT وXPD الفورية بعملة USD عبر REST وMCP.
- لم يطرأ تغيير على الذهب والفضة: الذهب بـ31 عملة، والفضة بعملة USD.
إزالة حقلي bid وask من الأسعار الفورية
- أُزيل حقلا bid وask من استجابات الأسعار الفورية. الحقول المتبقية: symbol, price, currency, unit, timestamp, stale.
أنواع قيم إضافية لمؤشرات الإصدارات الاقتصادية
- أُضيف الحقل annualization إلى كل مؤشر، بقيمة annualized أو not_annualized دائمًا.
- أُضيفت وحدات currency وratio وbalance إلى جانب index وpercent وthousands، مع الحقل currency (رمز ISO 4217) والحقل scale (units، thousands، millions، hundred_millions، billions) للمبالغ النقدية فقط.
- أُضيفت التحويلات quarter_over_quarter وthree_month_on_three_month وchange إلى جانب level وmonth_over_month وyear_over_year.
- أتحنا لـ reference_period وفترات القيم استخدام تواريخ نهاية الأسبوع (YYYY-MM-DD) ونوافذ متحركة لثلاثة أشهر (YYYY-MM/YYYY-MM)، إلى جانب الأشهر (YYYY-MM) والأرباع (YYYY-Qn) المدعومة سابقًا.
- وُضّح أن هذه الحقول قد تتضمن قيم تعداد جديدة مستقبلًا، وأنه ينبغي لتطبيقات العميل قبول القيم غير المعروفة بدلًا من فشل التحليل.
المشاهدات التاريخية لأسعار الصرف متاحة الآن
- تمت إضافة GET /v1/fx/rates/{base}/observations و fx_get_rate_history.
- أُضيفت نطاقات تواريخ تشمل تاريخَي البداية والنهاية، وصفحات تضم عددًا محدودًا من التواريخ، ومؤشرات متابعة معتمة مرتبطة بعوامل التصفية لاستكمال السجل التاريخي بالكامل.
- حُفظت تواريخ المشاهدات الفعلية دون استخدام قيم سابقة لملء عطلات نهاية الأسبوع أو العطلات الأخرى أو بيانات العملات المفقودة.
أصبحت هولندا متاحة في واجهة API للاقتصاد
- أُضيف NLD إلى جميع عمليات REST العامة التسع للبيانات الاقتصادية وأدوات MCP المطابقة.
- نُشرت بيانات شهرية لمؤشر أسعار المستهلك وسوق العمل وتجارة السلع، إضافة إلى بيانات ربع سنوية للناتج المحلي الإجمالي من Statistics Netherlands (CBS).
- أُضيفت تغطية هولندا ومنهجية المصدر ووثائق API والاكتشاف الآلي.
البيانات الاقتصادية التاريخية وتغطية هولندا
- أُضيفت تسع عمليات لاسترجاع المشاهدات التاريخية على صفحات عبر REST وMCP.
- أُضيفت البيانات الرسمية لهولندا عن التضخم وسوق العمل والناتج المحلي الإجمالي وتجارة السلع من CBS.
- وُسّعت واجهة API للاقتصاد المتاحة للجمهور لتشمل عشر دول و18 عملية.
النسخة التجريبية العامة للاقتصاد
- فُتحت تسع عمليات اقتصادية وطنية عبر REST وMCP.
- أُطلقت البيانات الرسمية الحالية للدول AUS وCAN وDEU وFRA وGBR وJPN وMYS وSGP وUSA.
- نُشر دليل البدء السريع للبيانات الاقتصادية وأُتيح الاكتشاف القابل للقراءة آليًا.