جميع واجهات API

واجهة API لأسعار المعادن الفورية

احصل على الأسعار الفورية للذهب والفضة والبلاتين والبلاديوم، إضافةً إلى أسعار مرجعية لخام WTI وخام برنت والنحاس مشتقة من أسواق العقود الآجلة، وليست أسعارًا فورية لشحنات فعلية.

احصل على مفتاح API مجاني
اقرأ التوثيق ‏←
متاح99.96% uptime, last 30 أيام357 ms زمن الاستجابة المعتاد

الطلب الأول

احصل على سعر الذهب بالدولار الأمريكي

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}

احصل على سعر فوري أو سعر مرجعي مشتق من العقود الآجلة.

المعلمات

  • 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منطقي

    هل السعر قديم. السوق المغلق لا يجعل السعر قديمًا أبدًا.


المرجع الكامل ‏←
GETاحصل على أشرطة الأسعار/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 من دولارات للبرميل إلى لترات وغالونات.

اقرأ الدليل ‏←

سعر النحاس للكيلوغرام والطن

حوّل النحاس من دولارات للرطل إلى كيلوغرامات وأطنان متريّة.

اقرأ الدليل ‏←

نسبة الذهب إلى الفضة

اقسم الذهب على الفضة لتواريخ أو أوقات متطابقة.

اقرأ الدليل ‏←

تنبيهات الأسعار

أرسل تنبيهًا عندما يتجاوز الذهب الحد الذي تحدده.

اقرأ الدليل ‏←

التغطية

واجهات API ذات صلة

واجهة API لأسعار السلع الفعلية

زيت النخيل وأسعار النفط والغاز اليومية وأسعار الوقود الأسبوعية للتجزئة في أمريكا والمؤشرات السلعية الشهرية، بالوحدات كما نُشرت.

استكشف 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.