احصل على تنبيه لسعر الذهب

احصل على تنبيه لسعر الذهب من حسابك في Plus أو Pro. في Free أو Basic، جدول فحصا عبر API واربطه بأداة الإشعارات التي تختارها. السعر الحالي هو ‏3,875.25 US$ للأونصة التروي عند 30 أكتوبر 2026، 21:08 UTC. تتأخر الأسعار المجانية خمس عشرة دقيقة.

• تتضمن كل من Plus وPro خمسة تنبيهات أسعار مدمجة.
• تفحص التنبيهات المدمجة الأسعار المباشرة وترسل طلبات POST موقعة إلى عنوان URL الخاص بك.
• في Free وBasic، جدول فحصا واحفظ آخر حالة.

أنشئ تنبيها مدمجا

تتضمن كل من Plus وPro خمسة تنبيهات أسعار. لا تتضمنها Free وBasic. قارن الخطط والأسعار، ثم سجل الدخول وافتح تنبيهات الحساب لإنشاء تنبيه. يراقب كل تنبيه معدنا واحدا: الذهب أو الفضة أو النحاس.

اختر قاعدة واحدة: عبور حد صعودا أو هبوطا أو في الاتجاهين، أو تغير بنسبة مئوية خلال ساعة أو أربع وعشرين ساعة، أو الإغلاق اليومي. تفحص التنبيهات الأسعار المباشرة. يرسل كل تنبيه إشعار عبور أو تغير واحدا كحد أقصى في الساعة، أو إشعار إغلاق واحدا في اليوم بتوقيت UTC.

جدول فحصا في Free أو Basic

في Free وBasic، شغل الطلب أدناه كل خمس عشرة دقيقة. يقرأ سعر الذهب للأونصة التروي من /v1/spot/XAU-USD-SPOT. حدد الحد الذي تختاره بالعملة والوحدة نفسيهما. لا تتطلب الطلبات دون مفتاح أي مفتاح أو تسجيل، لذا يمكنك البدء دون حساب.

ينتج عن هذا الجدول أربعة طلبات في الساعة، وستة وتسعون يوميا، ونحو ألفين وتسعمئة شهريا. وهو ضمن حدود الطلبات دون مفتاح: عشرة طلبات في الدقيقة ومئة في الساعة لكل IP، وضمن حصة المفتاح المجاني البالغة خمسة آلاف استدعاء شهريا.

curl "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT"

تحقق من التسليم والتوقيع

يرسل التنبيه المدمج طلب POST موقعا بجسم JSON إلى عنوان URL الذي تختاره. استخدم https على المنفذ 443 مع اسم مضيف عام. ترفض العناوين الخاصة والمحلية. يتضمن الجسم event وalert_id وkind وsymbol وdirection وprice وobserved_at. حقول القاعدة هي level، أو percent وwindow وreference_price، أو date وclose.

تكتب ترويسة Webhook-Signature بالصيغة t=<unix time>,v1=<HMAC SHA-256 of "<t>.<body>" with your signing secret>. احفظ سر التوقيع عند إنشاء التنبيه، لأنه يظهر مرة واحدة فقط. تحقق من التوقيع باستخدام جسم الطلب المستلم، وارفض التوقيعات الأقدم من خمس دقائق.

أرسل طلبا تجريبيا من صفحة التنبيهات لفحص عنوان URL المستلم. لا يرسل goldprice.dev بريدا إلكترونيا أو رسائل SMS. يصل طلب POST إلى عنوان URL تتحكم به، مثل عنوان webhook وارد لأداة محادثة أو خادم صغير.

احفظ الحالة للفحوص المجدولة

في الفحص المجدول، اقرأ is_stale وcomputed_at قبل مقارنة السعر. تتأخر الأسعار المجانية خمس عشرة دقيقة. استخدم أول قراءة صالحة لتحديد ما إذا كان السعر أعلى من الحد الذي اخترته أو أدنى منه، ثم احفظ هذه الحالة.

أرسل إشعارا عندما تعبر قراءة صالحة لاحقة الحد. في العبور الصاعد، تنتقل الحالة من أدنى الحد إلى مساواته أو تجاوزه. اعكس المقارنة للعبور الهابط. لا ترسل تنبيهات متكررة للقراءات المتتالية على الجانب نفسه. قد يفوت الفحص الدوري عبورا يعود فيه السعر بين فحصين.

اتبع شرح الإعداد

يعرض شرح تنبيهات الأسعار سكربتا يفحص السعر ويحفظ آخر حالة ويرسل طلبا إلى webhook وارد لخدمة محادثة. اتبعه لإعداد مسار يعمل من الطلب المجدول إلى الإشعار.

للإعداد دون كتابة سكربت، اتبع شرح سير العمل المجدول أو . تحقق من حداثة البيانات وتطابق الوحدات وحفظ الحالة في أي مسار تختاره. يرسل الإشعار عبر الأداة التي تختارها.