رموز السلع
استخدم XAU للذهب، وXAG للفضة، وXPT للبلاتين، وXPD للبلاديوم، وWTI لخام غرب تكساس الوسيط، وBRENT لخام برنت، وXCU للنحاس.
جميع واجهات API
واجهة API لأسعار المعادن الفورية
احصل على الأسعار الفورية للذهب والفضة والبلاتين والبلاديوم، إضافةً إلى أسعار مرجعية لخام WTI وخام برنت والنحاس مشتقة من أسواق العقود الآجلة، وليست أسعارًا فورية لشحنات فعلية.
الطلب الأول
دليل البدء السريع ←curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/spot/XAU/USD" \
--header "Authorization: Bearer $NARWHAL_API_KEY"استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
"symbol": "XAU-USD",
"price": "2500.00",
"currency": "USD",
"unit": "troy_ounce",
"timestamp": "2026-08-21T12:00:00Z",
"stale": true
}نقاط النهاية
GETاحصل على سعر فوري أو سعر مرجعي مشتق من العقود الآجلة./v1/commodities/spot/{commodity}/{currency}
GETاحصل على أعمدة أسعار الافتتاح والأعلى والأدنى والإغلاق للذهب والفضة والبلاتين والبلاديوم وWTI وBRENT. سجل أسعار النحاس غير متاح بعد./v1/commodities/spot/{commodity}/{currency}/bars
كيفية عمل البيانات
أحدث سعر
اقرأ السعر والطابع الزمني ومؤشر تقادم السعر معًا.
العملات
يُسعّر الذهب بـ31 عملة؛ وتُسعّر الفضة والبلاتين والبلاديوم وWTI وBRENT وXCU بعملة USD فقط.
التغطية
عرض التغطية ←أبقِ الطابع الزمني للسعر ظاهرًا في تطبيقك. لا يجوز عرض سعر متقادم على أنه سعر سوق حديث. وقد تتقادم الأسعار أثناء إغلاق الأسواق؛ وتُرجع الاستجابة stale: true خلال فترة التوقف اليومية 21:00-22:00 UTC.
استكشف الصفحات ذات الصلة
مرجع API
المعلمات وحقول الاستجابة.
اقرأ التوثيق ←واجهة API لأسعار السلع الفعلية
تابع زيت النخيل والفحم وأسعار التجزئة الأسبوعية للوقود في الولايات المتحدة والأسعار المرجعية الشهرية للسلع. تحتفظ كل سلسلة بسوقها ووحداتها المنشورة وفترة المشاهدة.
استكشف API ←الأسئلة الشائعة
ما وحدة الأسعار؟
قيمة الحقل unit هي troy_ounce للمعادن الثمينة، وbarrel لخامَي WTI وBRENT، وpound للنحاس XCU. الأونصة الترويسية تختلف عن الأونصة العادية.
ما العملات المتاحة؟
يُسعّر الذهب بـ31 عملة؛ وتُسعّر الفضة والبلاتين والبلاديوم وWTI وBRENT وXCU بعملة USD فقط. تعرض قائمة التغطية جميع السلع والعملات. تُرجع التركيبات الأخرى 404 currency_not_supported.