كل مصدر ظاهر

تمرير الأسعار لكل مصدر

تجمع معظم واجهات API للمعادن الأسعار من عدة تغذيات بيانات، وتحسب وسيطًا مرجّحًا، وتتخلص من المدخلات، وتقدّم لك رقمًا واحدًا. هذا المزج غير شفاف. عندما تختلف الأسعار بين البورصات (وهو ما يحدث يوميًا عند ترحيل العقود والتسوية وكل إغلاق للسوق)، لا يمكنك معرفة ما إذا كان رقم API يعكس الواقع أم الترجيح الداخلي لواجهة API.

تمر الأسعار الفورية من مصدر أساسي واحد مرخّص دون مزج أو حساب متوسط. أثناء الانقطاعات، يوفّر مصدر احتياطي مرخّص أسعار الذهب والفضة. لا يوجد مصدر احتياطي للنحاس. أضف ?include=sources لمعرفة المصدر الذي قدّم السعر، وسعره، وfetched_at وsource_timestamp.

GET /v1/prices?symbol=XAU-USD-SPOT&include=sources

{
  "symbol": "XAU",
  "price": "4803.94",
  "is_stale": false,
  "computed_at": "2026-05-01T02:34:02Z",
  "sources": [
    { "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
  ]
}

المصادر التي نستقبل بياناتها

فئات المصادر في كل مستوى. الدليل الخاص بكل طلب على تغذيات البيانات التي استُخدمت لأي سعر موجود في استجابة /v1/prices.

معرّفات المصادر، ودورات التحديث، وتفاصيل نقاط النهاية لدى المزوّدين موثّقة داخليًا وتتطور مع كل إصدار. إذا كنت تحتاج هذا المستوى من التفاصيل للتقييم القانوني، فأرسل حالة استخدامك إلى hello@goldprice.dev وسنرد عليك.

الأسعار بعملات غير USD على صفحات العملات هي السعر الفوري للذهب بـUSD مضروبًا في أسعار الصرف المباشرة من exchangerate.dev، واجهة API الشقيقة للعملات. لا تستخدم صفوف الأسعار الفورية بعملات غير USD أسعار صرف مخزّنة كبديل. إذا توقفت أسعار الصرف المباشرة، تستخدم /v1/convert و/v1/carat أحدث سعر صرف مخزّن لا يتجاوز عمره 3 أيام؛ وتحتفظ صفوف الأسعار الفورية بعملات غير USD بسعر متقادم.

تغذية الأسعار الفورية الاحتياطية

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

لا نستخدم المصدر الاحتياطي عندما يكون سوق المعادن مغلقًا: يوميًا من 17:00 إلى 18:00، ومن الجمعة 17:00 إلى الأحد 18:00، وجميع الأوقات بتوقيت نيويورك. لا يوجد مصدر احتياطي للنحاس. إذا توقفت تغذيته، يُوسم آخر سعر للنحاس بأنه متقادم.

التباعد بين المصادر

تتضمن الصفوف التي لديها مصدران أساسيان حديثان على الأقل divergence_bps: الفارق بينها بنقاط الأساس نسبةً إلى المتوسط. تستخدم صفوف الأسعار الفورية مصدرًا واحدًا وتحذف هذا الحقل. يسرد GET /v1/prices/divergence الرموز التي تتجاوز عتبة الفارق في جميع المستويات.

يبقى divergence_flag بالقيمة false في XAU-USD-SPOT؛ ويستخدم الذهب بعملات غير USD السعر الفوري بـUSD × أسعار الصرف المباشرة من exchangerate.dev.

حول تثبيت سعر LBMA

تقادم البيانات لكل مصدر

تتحول قيمة is_stale في المستوى الأعلى إلى true عندما يتأخر المصدر الذي يقدّم السعر عن نافذة تحديثه المتوقعة. أضف ?include=sources للاطلاع على سعر ذلك المصدر وfetched_at وsource_timestamp، وتقييم حداثة البيانات بنفسك.

النظرة المستقبلية: منحنى العقود الآجلة

يوفّر /v1/forward-view/{asset} مسار الأسعار المستقبلية الذي تعكسه السوق. يوضّح التفصيل أدناه الحسابات والمصدر ودورة التحديث.

منحنى العقود الآجلة

عقود الذهب الآجلة الـ5 التالية. تتأخر أسعار التسوية نحو 15 دقيقة عبر سلسلة تغذية البيانات المتأخرة الأساسية لدينا، مع مصدر احتياطي ثانوي. تأتي قيم العقود الآجلة من تغذيات بيانات متأخرة متاحة للعامة وليست بيانات مرخّصة في الوقت الفعلي. يصل الخط المتقطع بين نقاط التسوية الـ5؛ وتظهر فجوات عندما تفشل التغذية الأساسية والاحتياطية معًا لعقد ما. تُعالج بيانات العقود المفتوحة وحجم التداول على أساس بذل أفضل جهد، وتكون قيمتها null، ولا تُعرض في الاستجابة.

حداثة البيانات

تُحدّث أسعار تسوية العقود الآجلة في أيام الأسبوع عند 20:30 UTC: جدول واحد طوال العام، بعد التسوية بـ+2h في EDT وبـ+1h في EST، وثابت مع تغيّر التوقيت الصيفي.

ما لا نقدّمه

• تثبيت سعر LBMA انظر أعلاه.
• دفاتر أوامر L2 على مستوى كل تحديث سعري ننشر الأسعار، لا عمق السوق. دفاتر الأوامر على مستوى كل تحديث سعري خارج نطاق تغطية واجهة API هذه.
• ضمانات زمن استجابة أقل من ثانية لا ننشر اتفاقية SLA بزمن استجابة رقمي.
• المزج الخفي هذا هو جوهر هذه الصفحة.

الأسئلة الشائعة

من أين تأتي أسعارنا وكيف تعمل التغطية الاحتياطية.

من هما مزوّدا البيانات الأساسي والاحتياطي لديكم؟

نستخدم مزوّد بيانات سوق أساسيًا واحدًا مرخّصًا للذهب والفضة والنحاس. ويغطي مزوّد احتياطي مرخّص الذهب والفضة. لا نعلن اسم أي من المزوّدين.

هل سعركم الفوري سعر مركّب أم عرض سعر من جهة واحدة؟

نمرّر سعر المزوّد الأساسي دون مزج أو حساب متوسط. وهو ليس معيارًا رسميًا أو تثبيت سعر LBMA. يُرجع ?include=sources الحقل sources[] مع fetched_at وsource_timestamp.

ماذا يحدث إذا توقفت تغذية البيانات الأساسية؟

يوفّر مصدر احتياطي مرخّص أسعار الذهب والفضة أثناء عدم توفر المصدر الأساسي. قد يتأخر نحو دقيقتين ولا يتضمن سعر شراء أو بيع. لا يوجد مصدر احتياطي للنحاس. تتحول قيمة is_stale إلى true عندما يتأخر المصدر المستخدم عن نافذة تحديثه المتوقعة.

سجل تغييرات المنهجية

لإصدارات نقاط نهاية API والمستويات والمنتج بخلاف مراجعات المنهجية، راجع سجل تغييرات المنتج.

هل لديك أسئلة عن API؟ اقرأ التوثيق.