التوثيق
مرجع واجهة API للسلع
أسعار السلع الفعلية واكتشاف السلاسل وسجل الأسعار. تشمل أسعار التجزئة الأسبوعية للوقود في الولايات المتحدة والأسعار المرجعية الشهرية للبنك الدولي.
عنوان URL الأساسي
تغطي هذه الصفحة زيت النخيل الفعلي وأسعار الوقود الأمريكية والأسعار المرجعية الشهرية للسلع. للأسعار الفورية للمعادن الأربعة مرجع خاص بها هو مرجع الأسعار الفورية للمعادن. تبقى مراجع العقود الآجلة غير متاحة إلى أن يُطرح منتجها.
https://api.narwhalapi.com/v1/commodities- يستخدم كل طلب مفتاح Narwhal Bearer نفسه وحصة الحساب المشتركة.
- تستخدم REST وMCP مخططات الإدخال والإخراج نفسها.
عمليات الأسعار الفعلية
| عملية | مسار REST | أداة MCP |
|---|---|---|
| اكتشف سلاسل الأسعار الفعلية في Palmoil | /v1/commodities/palmoil/physical | commodities_list_palmoil_physical_series |
| احصل على أحدث سعر فعلي في Palmoil | /v1/commodities/palmoil/physical/{series_id} | commodities_get_palmoil_physical_price |
| احصل على سجل الأسعار الفعلية في Palmoil | /v1/commodities/palmoil/physical/{series_id}/observations | commodities_get_palmoil_physical_observations |
| اكتشاف سلاسل الأسعار الفعلية | /v1/commodities/physical/series | commodities_list_physical_series |
| الحصول على تفاصيل سلسلة أسعار فعلية | /v1/commodities/physical/series/{series_id} | commodities_get_physical_series |
| الحصول على أحدث سعر فعلي | /v1/commodities/physical/series/{series_id}/latest | commodities_get_physical_latest |
| الحصول على سجل الأسعار الفعلية | /v1/commodities/physical/series/{series_id}/observations | commodities_get_physical_observations |
السلوك المشترك
- تعيد عملية اكتشاف سلاسل الأسعار الفعلية السلاسل المكتملة والمعتمدة من حيث الحقوق فقط.
- يعيد CPO وFFB الماليزي قيمة سعرية واحدة. ويعيد FFB الإندونيسي جدول الأسعار الكامل حسب عمر الأشجار.
- تبقى الأسعار سلاسل نصية عشرية بعملتها ووحدتها الأصليتين.
- يأتي السجل من الأقدم إلى الأحدث ويستخدم مؤشرات غير قابلة للتفسير مرتبطة بالمرشحات.
- تفشل الجداول المفقودة أو المتداخلة أو الغامضة أو المختلطة الحقوق في اجتياز التحقق.
- لا تستهلك الطلبات المرفوضة أو غير المتاحة الحصة الشهرية.
التغطية
تشمل تغطية الوقود الأمريكية 20 سلسلة أسبوعية للبنزين العادي وديزل الطرق رقم 2. يغطي كل منتج متوسط الولايات المتحدة وتسع مناطق، بوحدة USD لكل غالون أمريكي. يبدأ سجل متوسط الولايات المتحدة في أغسطس 1990 للبنزين ومارس 1994 للديزل. تبدأ السلاسل الإقليمية لاحقًا. وتُضاف إلى السجل بيانات كل أسبوع بعد مسح يوم الاثنين. المصدر: إدارة معلومات الطاقة الأمريكية
تتوفر ثلاث سلاسل يومية للأسعار الفورية: خام WTI في كوشينغ منذ 2 يناير 1986 وخام برنت منذ 20 مايو 1987، وكلاهما بالدولار الأمريكي للبرميل؛ والغاز الطبيعي في هنري هب منذ 7 يناير 1997، بالدولار الأمريكي لكل MMBtu. المصدر: U.S. Energy Information Administration
استكشف API أسعار الوقود الأمريكية (الإنجليزية)
تشمل الأسعار المرجعية الشهرية 70 سلسلة للسلع الزراعية اللينة والزيوت والبذور الزيتية والمعادن والحبوب والطاقة والأسمدة والمنتجات الحرجية والماشية ومنتجات الألبان. يعود السجل إلى عام 1960. تبدأ بعض السلاسل لاحقًا أو تكون قد انتهت. الأسعار بوحدة USD وبالوحدات المنشورة. المصدر: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
استكشف API الأسعار التاريخية للسلع (الإنجليزية)
يشمل الإصدار أسعار CPO الحكومية المرجعية وجداول شراء FFB من إندونيسيا، ومتوسطات سوق CPO للتسليم المحلي ومراجع FFB الإقليمية من ماليزيا. وهي سلاسل منفصلة تختلف في المعنى والوحدات الأصلية.
تبدأ السلاسل في تواريخ مختلفة، وتتضمن فجوات موثقة في المصادر. لا تشمل البيانات عقود FCPO الآجلة. اقرأ تغطية السلع و المنهجية للحدود الدقيقة.
متاح باستخدام مفتاح Narwhal API.