سعر النفط للتر والغالون
حوّل برنت أو WTI من دولارات للبرميل إلى لترات وغالونات.
اقرأ الدليل ←احصل على الأسعار الفورية للذهب والفضة والبلاتين والبلاديوم، إضافةً إلى أسعار مرجعية لخام 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
}/v1/commodities/spot/{commodity}/{currency}احصل على سعر فوري أو سعر مرجعي مشتق من العقود الآجلة.
commodityمطلوبXAU وXAG وXPT وXPD وWTI (خام WTI) وBRENT (خام برنت) أو XCU (النحاس).
currencyمطلوبعملة التسعير بالأحرف الكبيرة. للذهب 31 عملة، وتُسعَّر البقية بالدولار الأمريكي فقط.
symbolسلسلة نصيةالسلعة وعملة التسعير، مثل XAU-USD.
currencyسلسلة نصيةعملة التسعير.
unitسلسلة نصيةtroy_ounce للمعادن الثمينة، وbarrel لـ WTI وBRENT، وpound لـ XCU.
priceسلسلة نصيةسعر إرشادي واحد موجب بصيغة سلسلة نصية لعدد عشري.
timestampتاريخ ووقتوقت السعر بتوقيت UTC.
staleمنطقيهل السعر قديم. السوق المغلق لا يجعل السعر قديمًا أبدًا.
/v1/commodities/spot/{commodity}/{currency}/barsأشرطة الافتتاح والأعلى والأدنى والإغلاق للذهب والفضة والبلاتين والبلاديوم والنحاس وWTI وBRENT.
commodityمطلوبXAU وXAG وXPT وXPD وWTI (خام WTI) وBRENT (خام برنت) أو XCU (النحاس).
currencyمطلوبعملة التسعير بالأحرف الكبيرة. للذهب 31 عملة، وتُسعَّر البقية بالدولار الأمريكي فقط.
intervalاختياري1m أو 5m أو 15m أو 1h أو 4h أو 1d. القيمة الافتراضية 1d.
startمطلوبالشريط الأول، بتوقيت UTC عند حدّ فاصل زمني. شاملة.
endمطلوبالشريط الأخير، بتوقيت UTC عند حدّ فاصل زمني. غير شاملة.
limitاختياريعدد الأشرطة في الصفحة. القيمة الافتراضية 100 والحد الأقصى 500.
cursorاختياريأعد استخدام next_cursor من الصفحة السابقة مع الاستعلام نفسه.
barsمصفوفةأشرطة مغلقة من الأقدم إلى الأحدث، ولكل منها طابع زمني وسعر الافتتاح والأعلى والأدنى والإغلاق كنصوص عشرية. الذهب بعملات غير USD له سعر الإغلاق فقط.
next_cursorسلسلة نصيةالمؤشر للصفحة التالية. يكون Null عندما لا تبقى أشرطة.
حوّل برنت أو WTI من دولارات للبرميل إلى لترات وغالونات.
اقرأ الدليل ←حوّل النحاس من دولارات للرطل إلى كيلوغرامات وأطنان متريّة.
اقرأ الدليل ←اقسم الذهب على الفضة لتواريخ أو أوقات متطابقة.
اقرأ الدليل ←أرسل تنبيهًا عندما يتجاوز الذهب الحد الذي تحدده.
اقرأ الدليل ←نزّل سجل سعر الذهب اليومي في ملف CSV.
اقرأ الدليل ←احصل على سعر سلعة بعملتك، مثل الروبية للغرام.
اقرأ الدليل ←زيت النخيل وأسعار النفط والغاز اليومية وأسعار الوقود الأسبوعية للتجزئة في أمريكا والمؤشرات السلعية الشهرية، بالوحدات كما نُشرت.
استكشف API ←أسعار الصرف الحالية وتحويل العملات وسجل الأسعار المخزَّن.
استكشف API ←البدء مجاني. رصيد مجاني بقيمة 10 دولارات كل شهر، ثم 2 دولار لكل 1,000 استدعاء.
عرض الأسعار ←قيمة الحقل unit هي troy_ounce للمعادن الثمينة، وbarrel لخامَي WTI وBRENT، وpound للنحاس XCU. الأونصة الترويسية تختلف عن الأونصة العادية.
يُسعّر الذهب بـ31 عملة؛ أما الفضة والبلاتين والبلاديوم وWTI وBRENT وXCU فبعملة USD فقط. تعرض قائمة التغطية كل سلعة وعملة. تُرجع السلعة غير المعروفة 404 commodity_not_supported؛ وتُرجع السلعة المعروفة بعملة غير مدعومة 404 currency_not_supported.
أبقِ الطابع الزمني للسعر ظاهرًا في تطبيقك. لا تعرض سعرًا قديمًا على أنه سعر سوق حديث. تتوقف أسواق المعادن يوميًا عند 17:00 بتوقيت نيويورك (21:00 UTC صيفًا، و22:00 UTC شتاءً). هذا التوقف ليس إغلاقًا للسوق، وقد تحمل الأسعار خلاله stale: true. إغلاق السوق وحده لا يجعل السعر قديمًا: من الجمعة 17:00 إلى الأحد 17:00 بتوقيت نيويورك تحصل على آخر سعر مع stale: false.
رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.رصيد مجاني بقيمة 10 دولارات كل شهر، دون بطاقة.