خطافات الويب (Webhooks)

goodcryptoX يتيح لك أتمتة إجراءات التداول عبر webhooks من TradingView — آلية قوية لتشغيل الأوامر وإجراءات البوت مباشرة من إشاراتك.

على عكس بعض التنفيذات التي تعامل webhooks كواجهة برمجة قابلة للبرمجة (حيث ترسل أوامر مُعلمة مثل "اشترِ 3 BTC"), يدعم goodcryptoX حاليًا نموذجًا قائمًا على المشغلات. كل webhook يقوم ببساطة بتنشيط إجراء محدد مسبقًا في طلب أو بوت معين — لا يتم تفسير أي معلمات أو أوامر.

في المستقبل القريب، سنطلق بوت استراتيجية TradingView الذي يدعم تعليمات استراتيجية كاملة عبر webhooks، بما في ذلك اختيار الرموز الديناميكي، والكميات، وأنواع الأوامر، ومنطق متعدد الرموز — يعمل فعليًا كطبقة API. ترقبوا

الأمن والوصول

• يتم قبول webhooks فقط من خوادم TradingView في الوقت الحالي — لا توجد عناوين IP مخصصة أو مصادر خارجية.

• إذا كنت بحاجة لاستخدام مصدر webhook مخصص، اتصل بنا على [email protected] لطلب الوصول.

• تتوفر webhooks فقط للمستخدمين الذين لديهم خطة PRO أو أعلى.

كيف تعمل webhooks في goodcryptoX

• كل طلب أو بوت إجراء له عنوان URL خاص بالـ webhook مخصص

• يجب عليك إنشاء الطلب أو البوت أولاً للحصول على عنوان URL (ستظهر في Webhooks قسم تفاصيل)

• إرسال أي حمولة webhook إلى ذلك العنوان ستؤدي إلى تشغيل الإجراء

عناوين URL الخاصة بالـ Webhook مخصصة للإجراء، وليس للمستخدم. يجب عليك إنشاء webhook واحد لكل إجراء، على سبيل المثال واحد للدخول، واحد لجني الأرباح، واحد لإيقاف الخسارة، إلخ. لكل بوت أو طلب

الأوامر وإجراءات البوت المدعومة

إذا كنت تريد أن يتم تنشيط طلبك أو بوتك بواسطة webhook، يجب عليك اختيار webhook كـ شرط التشغيل أثناء الإعداد. هذا ينطبق على:

• أوامر إيقاف السوق / إيقاف الحد يتم تشغيلها

• تنشيط أوامر التتبع (بدء التتبع)

• تنشيطات جني الأرباح وإيقاف الخسارة

• شرط دخول بوت DCA

بعد الإنشاء، ستجد جميع عناوين URL الخاصة بالـ webhook المتاحة في تفاصيل تفاصيل طلبك أو بوتك:

إلغاء webhook — متاح دائمًا في جميع الطلبات والبوتات

إغلاق المركز webhook — متاح دائمًا في تفاصيل بوت DCA

للخلاصة:

الإجراء	مدعوم؟	ملاحظات
إلغاء الطلب	✅	معروض دائمًا في التفاصيل
تفعيل أمر إيقاف	✅	يجب اختيار webhook أثناء الإعداد
تنشيط أمر تتبعي	✅	بدء التتبع = webhook
تشغيل جني الأرباح / إيقاف الخسارة	✅	اختياريًا يتم تشغيله بواسطة webhook
بوت DCA - الدخول	✅	الدخول شراء/بيع عبر webhook (يجب تعيينه أثناء الإعداد)
بوت DCA - الخروج	✅	إغلاق المركز عبر webhook (متاح دائمًا)
بوت الشبكة - الدخول	🚫	غير مدعوم بعد

أهداف جني أرباح متعددة عبر webhooks

إذا قمت بإعداد مجموعة جني أرباح باستخدام webhook كطريقة تشغيل، فستشارك جميعها نفس عنوان URL للـ webhook. في كل مرة يتم فيها تشغيل الـ webhook، سيتم تنفيذ هدف TP التالي في التسلسل — واحدًا تلو الآخر.

كيفية إعداد التنبيهات في TradingView

بعد إنشاء طلبك أو البوت في goodcryptoX ونسخ عنوان URL للـ webhook لإجراء محدد، إليك كيفية ربطه بتنبيهات TradingView:

1. اذهب إلى الرسم البياني الخاص بك في TradingView

2. أنشئ تنبيهًا جديدًا بناءً على استراتيجيتك أو المؤشر أو الشرط

3. في إعدادات التنبيه، قم بتمكين خانة الاختيار “Webhook URL”

4. الصق عنوان URL المحدد للـ webhook من قسم Webhooks في goodcryptoX

5. اترك حقل الرسالة كما هو (أي محتوى مقبول — goodcryptoX يتجاهل الحمولة في الوقت الحالي)

6. احفظ التنبيه

الاستراتيجيات المتكررة (عبر بوت DCA)

الأمر المشغل بواسطة webhook (مثل stop-market مع TP وSL) هو إعداد لمرة واحدة. بمجرد تنفيذ الأمر وإطلاق TP أو SL المرتبطين به، تكتمل الصفقة بأكملها. إذا أردت أن يتكرر تلقائيًا، فهذا غير ممكن مع الأوامر — لكنه قابل للتحقيق الآن باستخدام بوت DCA.

سنقوم قريبًا بتقديم بوت استراتيجية TradingView مخصص لدعم تداولات متعددة الإجراءات قابلة للتكرار، ولكن في هذه الأثناء، يوفر بوت DCA طريقة مرنة لتكرار استراتيجيتك القائمة على webhooks.

حلقة webhook فقط

لإعداد بوت يدخل موقفًا عبر webhook، يخرج عبر webhook، ثم يتكرر:

1. اضبط شرط الدخول = webhook

2. اضبط أوامر المتوسط = 0 (تعطيل المتوسط)

3. عطل كلاً من جني-الأرباح و إيقاف الخسارة

4. قم بتمكين "التكرار عند إغلاق المركز"

بمجرد إطلاق البوت، سترى عناوين URL التالية للـ webhook تحت تفاصيل → Webhooks القسم:

• دخول شراء — يفتح مركزًا طويلًا

• دخول بيع — يفتح مركزًا قصيرًا

• إغلاق المركز — يغلق المركز النشط (طويل أو قصير)

• إلغاء — يوقف البوت

منطق التنفيذ

• عندما يتلقى البوت دخول شراء، يفتح مركزًا طويلاً.

• عندما يتلقى دخول بيع، يفتح مركزًا قصيرًا.

• سيقوم البوت بالاستجابة فقط لأول webhook دخول يتلقاه بينما يكون في حالة خمول.

• أثناء فتح مركز:

  • أي إشارات دخول إضافية تكون مهملة

  • لن يزيد البوت أو يعكس المركز الحالي استنادًا إلى إشارات الدخول

  • الإشارات الوحيدة المقبولة هي إغلاق المركز أو TP/SL مُشغل (إذا تم تكوينه)

• بمجرد إغلاق المركز (يدويًا، بواسطة webhook، أو بواسطة SL/TP)، يعيد البوت ضبط حالته وينتظر webhook الدخول التالي.

تستمر هذه الحلقة طالما ظل البوت نشطًا، مما يتيح لك تكرار دورة دخول → خروج → إعادة ضبط كاملة إلى أجل غير مسمى.

وضع webhook الخالص مقابل الإعدادات المختلطة

يدعم بوت DCA عدة طبقات تحكم يمكن دمجها لبناء استراتيجيات مرنة:

• الدخول: عبر webhook أو إشارة أو فورًا

• الخروج: عبر webhook أو جني أرباح/إيقاف خسارة مدمج قائم على السعر

• المتوسط: اختياري؛ يمكن تعطيله

يمكنك:

• تشغيل بوت بالكامل عبر إشارات webhook (دخول وخروج)

• إضافة جني أرباح/إيقاف خسارة قائمين على السعر كخطط احتياطية، حتى لو كنت تستخدم إنهاءات عبر webhook

• إضافة أوامر متوسط للحماية الإضافية

هذا يجعل من الممكن تصميم:

• استراتيجيات حلقة مؤتمتة بالكامل (webhook الخالص)

• بوتات مدفوعة بالإشارات مع تحويلات فشل يدوية

• إعدادات هجينة مع مخارج متعددة الطبقات

أمثلة عملية على استراتيجيات webhook

المثال 1: أمر لمرة واحدة + أهداف جني أرباح متعددة (ارتداد نطاق بولينجر)

الهدف: الشراء عندما يخترق السعر نطاق بولينجر السفلي، والبيع تدريجيًا مع ارتفاعه.

الإعداد في goodcryptoX

• أنشئ أمر stop-market مع شرط تشغيل = webhook

• أضف ثلاث أهداف جني أرباح. مشغل TP = webhook

الإعداد في TradingView

أنشئ أربعة تنبيهات:

1. السعر يخترق النطاق السفلي → أرسِل إلى مشغل عنوان URL للـ webhook الخاص بالطلب الرئيسي

2. السعر يعود داخل النطاق → أرسِل إلى مشغل جني الأرباح عنوان URL للـ webhook الخاص بالطلب الرئيسي

3. السعر يعبر الشريط الوسطي → أرسِل إلى مشغل جني الأرباح عنوان URL للـ webhook الخاص بالطلب الرئيسي

4. السعر يخترق النطاق العلوي → أرسِل إلى مشغل جني الأرباح عنوان URL للـ webhook الخاص بالطلب الرئيسي

في إعدادات التنبيه، قم بتمكين خانة الاختيار “Webhook URL”

الصق عنوان URL المحدد للـ webhook من قسم Webhooks في goodcryptoX. اترك حقل الرسالة كما هو — لا يُستخدم.

المثال 2: استراتيجية متكررة باستخدام بوت DCA (التقاطع الذهبي/الموت)

الهدف: ادخل شراء عند التقاطع الذهبي، ادخل بيع عند تقاطع الموت. اخرج بربح 10% أو عندما يكون RSI > 70 وكرر إلى الأبد.

الإعداد في goodcryptoX

أنشئ بوت DCA

• شرط الدخول = webhook

• المتوسط = إيقاف (اضبط على 0)

• جني الأرباح = 10%

• إيقاف الخسارة = إيقاف

• قم بتمكين: "التكرار عند TP"

الإعداد في TradingView

• أنشئ ثلاثة تنبيهات على نفس الرسم:

  1. SMA50 يتقاطع فوق SMA200 → أرسِل إلى دخول شراء webhook

  2. SMA50 يتقاطع تحت SMA200 → أرسِل إلى دخول بيع webhook

  3. RSI > 70 → أرسِل إلى إغلاق المركز webhook

يحتفظ بوت DCA بمركز واحد فقط في كل مرة. أثناء تواجد المركز، يتجاهل webhooks الدخول الجديدة حتى يتم إغلاق المركز.

إذا أردت أن تكون قادرًا على دخول مراكز شراء وبيع على نفس الأداة بشكل متوازي - أنشئ بوتين منفصلين وأرسل Enter Buy إلى أحدهما وEnter Sell إلى الآخر

الملخص

المفهوم	الوصف
نموذج التشغيل	كل إجراء له عنوان URL خاص به للـ webhook
تدفق الإعداد	إنشاء طلب → نسخ عنوان URL للـ webhook → لصقه في تنبيه TradingView
الاستراتيجية المتكررة	استخدم بوت DCA مع تمكين التكرار
الوصول	يتطلب خطة PRO أو أعلى

دروس فيديو

مقدمة لتداول webhooks

استخدام بوت DCA مع webhooks

أهداف جني أرباح متعددة عبر webhooks