AlgoVesta › المسرد › Webhook

الإشارات والأتمتة

Webhook

الـ Webhook هو طلب HTTP آلي ترسله تطبيق ما إلى عنوان URL في تطبيق آخر لحظة وقوع حدث ما؛ ففي التداول، يرسل TradingView webhook إلى منصة أتمتة عندما يُطلَق تنبيه استراتيجية أو مؤشر، بحيث يمكن وضع الأمر دون أن ينقر أحد على زر.

لماذا هذا مهم

لا تزال التنبيهات عبر البريد الإلكتروني أو إشعار التطبيق أو الصوت تحتاج إلى شخص ليتصرف بناءً عليها. أما الـ Webhook فينقل نص رسالة التنبيه مباشرة إلى المنصة التنفيذية، وهذا ما يحوّل استراتيجية TradingView إلى استراتيجية آلية. نص الرسالة تحت سيطرتك بالكامل: يمكن أن يكون نصاً ثابتاً مثل "BTCUSDT LONG" أو حمولة JSON بعناصر نائبة يملؤها TradingView وقت التنبيه (الرمز، السعر، الإجراء، حجم الصفقة). تقوم المنصة المستقبِلة بتحليل ذلك النص، والتحقق منه مقابل قواعدك، ثم وضع الصفقة.

كيف تتعامل AlgoVesta مع ذلك

تحصل كل استراتيجية في AlgoVesta على عنوان Webhook خاص بها يحتوي على رمز سري؛ تلصقه في حقل "Webhook URL" الخاص بتنبيه TradingView وتضع قالب JSON من لوحة التحكم في مربع الرسالة. تُقبَل الطلبات الواردة للتنفيذ الحي فقط عندما يمكن التحقق من المصدر، إما لأن الطلب يأتي من عناوين IP المنشورة رسمياً لدى TradingView أو من عنوان IP أدرجته في القائمة البيضاء؛ أما أي شيء آخر فيُسجَّل ولا يُتداول به. تُحلَّل الحمولة إلى الرمز، والاتجاه، وتلميح الدخول، ووقف الخسارة (SL) وجني الأرباح (TP)، ثم تُوجَّه إلى الهدف الذي اخترته لتلك الاستراتيجية: حساب بورصة عملات رقمية أو حساب MetaTrader 5. تغلق خروجات الاستراتيجية ("flat") الصفقة المفتوحة بدلاً من فتح الجانب المعاكس، ويعمل المنطق نفسه في الوضع التجريبي (paper) بحيث يمكنك اختبار التنبيه من البداية للنهاية قبل التداول الحقيقي. يتم استقبال الإشارة وتحليلها في أقل بكثير من 100 مللي ثانية؛ وقد تم قياس وصول الأمر إلى المنصة، من البداية للنهاية، في نحو 4.1 ثانية على بورصات العملات الرقمية ونحو 1.2 ثانية على MT5 في المتوسط. خطوات الإعداد موجودة في صفحة روبوت TradingView وفي دليل إعداد الـ Webhook.

مثال

رسالة التنبيه: {"symbol":"{{ticker}}","side":"buy","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}}}. عندما تُطلَق الاستراتيجية على رسم بياني ETHUSDT، يستبدل TradingView العناصر النائبة وينشر ملف JSON إلى عنوان URL الخاص بالاستراتيجية. تفتح AlgoVesta صفقة الشراء بالهامش المضبوط عند 100 دولار، وتضع الوقف والهدف من المؤشرين، وتعرض الصفقة في لوحة التحكم خلال ثوانٍ.

أخطاء شائعة

من الناحية العملية

بوت TradingView →