Webhook TradingView

Webhook TradingView لـ MT4 وMT5 وcTrader

يمكن لـ TradingView إرسال webhook عبر HTTP عند انطلاق تنبيه، لكنه لا ينفذ وحده على MetaTrader أو cTrader. يستقبل TheConnector التنبيه ويفحص الحمولة ويوجه التعليمة إلى الحساب المختار مع سجل حالات واضح.

نقطة webhook من TradingView لرسائل التنبيه مسارات MT4 وMT5 وcTrader في مسار واحد حالات Received وRouting وACK وDelivered مرئية وصول مجاني قبل الإطلاق، دون بطاقة دفع

نص التنبيه

alert-payload.json
{
  "action":  "buy",
  "symbol":  "EURUSD",
  "volume":  0.10,
  "sl":      1.0820,
  "tp":      1.0910
}
الصق رابط webhook الخاص بحسابك في تنبيه TradingView ثم أرسل رسالة JSON هذه. تبقى كل مرحلة (Received, Route, ACK, Delivered) مرئية في لوحة التحكم.
الإجراءات المتاحة
buy sell — أمر سوق (بدائل long / short)
buylimit buystop selllimit sellstop — أمر معلّق — أضف حقل price
closelong closeshort closelongshort — يغلق المركز/المراكز على هذا الرمز
cancellong cancelshort — يلغي أمراً معلّقاً
newsltplong newsltpshort — يحدّث SL/TP (بدائل breakeven…)

القائمة الكاملة والبدائل: مرجع صياغة الأوامر.

ما الذي يفعله webhook من TradingView

الـ webhook هو طبقة النقل: يرسل رسالة التنبيه إلى رابط. أما التنفيذ فيعتمد على bridge والطرفية والوسيط وقواعد الحساب.

  • يطلق TradingView التنبيه
  • يتحقق TheConnector من الحمولة
  • تتلقى الطرفية التعليمة الموجهة إليها فقط

مسار الإعداد الموصى به

ابدأ بحساب واحد ورسالة JSON مقروءة. أضف ربط الرموز وSL/TP والتوجيه متعدد الحسابات فقط بعد ظهور المسار الأول في لوحة التحكم.

  • أنشئ مسار الحساب
  • انسخ رابط webhook الخاص بالحساب
  • أكد السجل قبل زيادة الحجم

اختلافات MT4 وMT5 وcTrader

يمكن أن يبقى تنسيق webhook ثابتاً، لكن لكل منصة طرفيتها وصلاحياتها ورموزها وقيود التنفيذ الخاصة بها.

  • MT4: صلاحيات EA وAutoTrading ولواحق الوسيط
  • MT5: netting أو hedging ونمط التنفيذ وخطوة الحجم
  • cTrader: cBot أو bridge وصلاحيات Automate وأسماء الرموز

متى تقارن البدائل

قارن الأدوات بحسب المسارات المغطاة ووضوح الأخطاء وإمكانية الاختبار قبل الدفع أو نقل حساب حقيقي.

  • ينبغي أن تبقى صفحات بديل PineConnector موضوعية
  • دعم cTrader معيار مستقل
  • يجب أن تنتهي الأوامر المتأخرة لا أن يعاد تشغيلها

تعامل مع رابط webhook كأنه كلمة سر

لكل مسار حساب رابط webhook خاص يحمل رمز توجيه: من يملك الرابط يستطيع إرسال إشارات إلى ذلك المسار. لا تلصقه أبداً في Pine Script عام أو منتدى أو لقطة شاشة. تُرفض الطلبات ذات الرموز المجهولة عند الحافة قبل وصولها إلى حساباتك، وعند الاشتباه بتسريب أوقف الحساب مؤقتاً أو عطّله من اللوحة وتواصل مع الدعم لتدوير المسار.

  • رابط لكل مسار حساب يحمل رمزه
  • لا تنشره أبداً في سكربتات أو منتديات أو لقطات
  • تُرفض الرموز المجهولة قبل وصولها لحساباتك

ما يشترطه TradingView لإرسال webhook

ثلاثة شروط من جهة TradingView، لا يُرسَل شيء من دونها. لا يظهر حقل Webhook URL إلا في خطة مدفوعة، Essential أو أعلى، ولا يرسل TradingView أي webhook إلا إذا كانت المصادقة الثنائية مفعّلة على الحساب. ثم يجب أن يستجيب العنوان بسرعة: بعد 3 ثوانٍ يلغي TradingView الإرسال، ولا يُقبل إلا المنفذان 80 و443.

  • خطة Essential أو أعلى، مع تفعيل المصادقة الثنائية
  • عنوان https على المنفذ 443: وهذا حال عنوان الـ webhook في TheConnector
  • لا IPv6: يرسل TradingView عبر IPv4، من أربعة عناوين ثابتة

JSON أو نص: الصيغتان مقبولتان

إذا كانت رسالة التنبيه بصيغة JSON صالحة، يرسلها TradingView مع الترويسة application/json؛ وإلا فبصيغة text/plain. ويقرأ TheConnector الصيغتين. ويبقى JSON الصيغة الموصى بها: فكل حقل مسمّى، والحقل الناقص يظهر فوراً. أما الصيغة المكتوبة في سطر واحد والمفصولة بفواصل، فتفيد حين يجب أن تبقى الرسالة قصيرة.

message.txt
{"action":"buy","symbol":"EURUSD","risk":1,"sl":0.2,"tp":0.4,"priceMode":"percent"}

buy,EURUSD,risk=1,sl=0.2,tp=0.4,priceMode=percent
  • JSON: حقل مسمّى لكل معلومة
  • نص: الأمر، والرمز، ثم إعدادات اسم=قيمة
  • نسيان علامة تنصيص واحدة يجعل الـ JSON يُرسَل نصاً: افحصه بأداة الاختبار

الـ webhook من TradingView لا يعمل: قائمة التحقق

تابع التنبيه بالترتيب الذي يسلكه. من جهة TradingView أولاً: يبيّن سجل التنبيهات ما إذا كان التنبيه قد انطلق وما إذا كان الـ webhook قد أُرسل. ثم من جهة TheConnector: يُظهر سجل التنبيهات ما إذا كانت الرسالة قد وصلت، وإلا فسبب رفضها. وأخيراً من جهة الطرفية: يجب أن يكون الروبوت متصلاً، والتداول الآلي مسموحاً، والرمز والحجم مقبولَين لدى وسيطك.

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

فحص رسالة دون مخاطرة

تُمرِّر أداة اختبار webhook، المجانية ودون حساب، رسالتك عبر المحلل نفسه الذي تستخدمه بوابة الإنتاج، ثم تتوقف عند ذلك: فتعرض الأمر والرمز والحجم والوقف والهدف كما تقرؤها، أو السبب الدقيق للرفض. لا يُرسَل أي أمر تداول. وهي أول ما يُلجأ إليه حين يُرفض تنبيه بسبب صيغته.

  • المحلل نفسه المستخدم في الإنتاج
  • لا حساب، ولا أمر
  • السبب الدقيق عند الرفض

من أول اختبار إلى الإنتاج

التصعيد الآمن له ثلاث مراحل. أولاً حساب تجريبي وتنبيه يدوي واحد: راقبه يعبر Received وRouting وACK وDelivered في اللوحة. ثم دع الاستراتيجية تطلق تنبيهات حقيقية نحو المسار التجريبي لبضع جلسات وراجع السجل — حالات الرفض وثغرات الربط واستهلاك الحصة. عندها فقط وجّه التنبيه إلى حساب حقيقي بادئاً بأقل حجم. خطة Basic المجانية (15 webhook يومياً لكل حساب) مصممة تماماً لمرحلة التحقق هذه.

  • المرحلة 1: تنبيه يدوي واحد إلى مسار تجريبي
  • المرحلة 2: تنبيهات استراتيجية حقيقية على التجريبي
  • المرحلة 3: حساب حقيقي بأقل حجم

أدلة ذات صلة

FAQ

هل تنفذ webhooks من TradingView مباشرة على MT4 أو MT5؟

لا. يرسل TradingView الرسالة فقط. يلزم bridge أو روبوت طرفية أو cBot لتوجيه التعليمة إلى المنصة.

أي منصة تختار لـ webhook من TradingView؟

استخدم المنصة التي يدعمها وسيطك ومسارك. لدى MT4 وMT5 وcTrader صلاحيات ورموز وقيود مختلفة.

هل TheConnector بديل لـ PineConnector؟

يمكن تقييمه كمسار بديل لـ webhooks من TradingView، خصوصاً عند أهمية cTrader والاستضافة في الاتحاد الأوروبي والتحقق عبر Basic. PineConnector علامة لطرف ثالث.

هل يضمن webhook تنفيذ الوسيط؟

لا. يحسن webhook التوجيه والتتبع، لكن التنفيذ يعتمد على الطرفية والوسيط وقواعد الحساب والسوق وإعدادات المخاطرة.

هل هذا نصيحة مالية؟

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

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

يُرفض الأمر ويذكر السجل السبب، فترى بالضبط ما حدث. لا شيء يُعاد بصمت عند الافتتاح التالي بسعر غير متوقع: التسليم مرة واحدة على الأكثر، والأمر الذي يتجاوز نافذته المفيدة تنتهي صلاحيته عبر TTL.

هل يجب أن أعرف البرمجة؟

لا. رسالة التنبيه مقتطف JSON صغير تنسخه في صندوق تنبيهات TradingView — وتوفر الوثائق وصفحة أمثلة Pine Script قوالب جاهزة. معرفة Pine Script لا تهم إلا إذا كانت استراتيجيتك تولّد التنبيهات برمجياً.

لماذا لا يرسل TradingView الـ webhook الخاص بي؟

تحقّق بهذا الترتيب: خطة مدفوعة (Essential أو أعلى)، والمصادقة الثنائية مفعّلة، وعنوان https دقيق، وحالة الإرسال في سجل تنبيهات TradingView. وإذا أُرسل الـ webhook ولم يصل شيء، فالمشكلة في العنوان أو في مفتاح الحساب.

هل يقبل الـ webhook من TradingView نصاً بدلاً من JSON؟

نعم. يرسل TradingView أي رسالة، JSON كانت أو نصاً، ويقرأ TheConnector الصيغتين. لكن JSON يبقى أكثر أماناً: فكل حقل مسمّى، والخطأ يُكتشف فوراً.