كيف ترسل webhook من TradingView إلى MetaTrader 5

تنبيهات TradingView ممتازة في إخبارك متى تتحرك — لكنها لا تنفّذ أي أمر حقيقي أبدًا. فالتنبيه مجرد إشعار. ولتحويل «اشترِ EURUSD» إلى صفقة فعلية على MetaTrader 5، لا بد من جهة تستقبل هذا التنبيه وتنفّذه لدى وسيطك. وعادةً ما يعني ذلك جهاز كمبيوتر أو VPS يعمل على مدار الساعة. يشرح لك هذا الدليل كيفية ربط TradingView بمنصة MT5 عبر webhook، وكيف يتولى etrink العملية كلها نيابةً عنك — بلا كمبيوتر ولا VPS.

ما هو webhook في TradingView؟

الـ webhook ببساطة عنوان URL يستدعيه TradingView لحظة إطلاق التنبيه. فبدلًا من الاكتفاء بعرض نافذة منبثقة أو إرسال بريد إلكتروني، يرسل TradingView طلب HTTP POST إلى عنوان تحدده أنت، مع نص رسالة تكتبه أنت. يمكن أن تكون هذه الرسالة نصًا عاديًا، أو — وهو الأنفع بكثير — بصيغة JSON: بيانات منظَّمة يستطيع البرنامج قراءتها والتصرف بناءً عليها.

إذن الـ webhook نفسه لا «يتداول». إنه رسول في اتجاه واحد: «هذا الشرط تحقق للتو، وهذه بياناته.» ولا بد من جهة في الطرف الآخر تستمع لهذه الرسالة وتقرر ما تفعله بها.

لماذا تحتاج إلى جهة تستقبله

يرسل TradingView الـ webhook بلا تردد، لكنه لا يملك أي اتصال بوسيطك. والجزء الأهم هو المستقبِل، إذ يجب عليه أن:

• يكون متصلًا على مدار الساعة طوال الأسبوع — فالأسواق والتنبيهات لا تنتظر استيقاظ حاسوبك المحمول.
• يتحقق من صحة الطلب، حتى لا يتمكن رابط مسرَّب من استنزاف حسابك.
• يترجم الـ JSON إلى أمر MetaTrader 5 حقيقي (الرمز، الاتجاه، الحجم، أوامر الإيقاف).
• يتعامل مع حالات الرفض بسلاسة — اسم رمز خاطئ، مستوى إيقاف غير صالح، حجم يتجاوز الحد.

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

خطوة بخطوة: تنبيه TradingView ← أمر MetaTrader 5

1. أنشئ مفتاحك. في لوحة etrink افتح Webhook، واختر حساب MT5 المراد ربطه، ثم انقر + مفتاح جديد. انسخ الرابط الذي يظهر مرة واحدة فقط:

https://api.etrink.com/hooks/etrk_xxxxxxxxxxxxxxxx

2. أنشئ التنبيه في TradingView. افتح أي رسم بياني، وأضف تنبيهًا (أيقونة المنبّه)، وحدد شرطك — تقاطع، أو مستوى مؤشر، أو إشارة استراتيجية.
3. فعّل Webhook URL. في تبويب Notifications الخاص بالتنبيه، حدّد خيار Webhook URL والصق رابط etrink أعلاه. (تتطلب خاصية الـ webhook اشتراكًا مدفوعًا في TradingView.)
4. اكتب الرسالة. الصق محتوى JSON (في القسم التالي) في حقل Message الخاص بالتنبيه.
5. احفظ واختبر. عند تحقق الشرط يرسل TradingView طلب POST إلى etrink، فيُتحقق من الطلب ويُنفَّذ الأمر على حسابك المرتبط. وتُسجَّل كل إشارة في لوحتك.

تجد المرجع الكامل للحقول في توثيق الـ webhook.

صيغة رسالة التنبيه (JSON)

هذا أبسط أمر شراء بسعر السوق ممكن. الصقه مباشرةً في خانة Message في TradingView:

{
  "action": "buy",
  "symbol": "EURUSD",
  "volume": 0.01,
  "sl": 0,
  "tp": 0
}

هنا تعني sl:0 وtp:0 عدم وجود أوامر إيقاف — يُفتح الأمر دون وقف خسارة أو جني أرباح. وهذا هو الإعداد الافتراضي الأكثر أمانًا أثناء الاختبار، لأن أمر الإيقاف الموضوع في غير مكانه هو السبب الأكثر شيوعًا لرفض الوسيط للأمر.

عندما تكون مستعدًا لإضافة أوامر الإيقاف، تذكّر قاعدة الاتجاه: في أمر الشراء (buy) يجب أن يكون وقف الخسارة أسفل السعر الحالي وجني الأرباح أعلاه (والعكس في البيع). والترتيب الخاطئ يرفضه الوسيط لا etrink:

{
  "action": "buy",
  "symbol": "EURUSD",
  "volume": 0.01,
  "sl": 1.0820,
  "tp": 1.0920
}

أمر البيع مماثل، والحجم اختياري إذا حددت قيمة افتراضية لكل حساب:

{ "action": "sell", "symbol": "XAUUSD", "volume": 0.05 }

يمكنك أيضًا أن تدع TradingView يملأ القيم لحظة الإرسال باستخدام متغيراته البديلة، إذ يستبدل {{ticker}} و{{strategy.order.action}} و{{close}} قبيل إرسال الطلب مباشرةً:

{ "action": "{{strategy.order.action}}", "symbol": "{{ticker}}", "volume": 0.01 }

مثال بلغة Pine Script

إذا كانت إشاراتك صادرة عن استراتيجية، فاستخدم استدعاء alert() داخل كود Pine لكي تُرسَل رسالة JSON المطلوبة بالضبط عند تحقق شروطك:

//@version=5
strategy("etrink signal", overlay=true)

fast = ta.sma(close, 10)
slow = ta.sma(close, 30)

if ta.crossover(fast, slow)
    strategy.entry("Long", strategy.long)
    alert('{"action":"buy","symbol":"EURUSD","volume":0.01,"sl":0,"tp":0}',
          alert.freq_once_per_bar_close)

if ta.crossunder(fast, slow)
    strategy.close("Long")
    alert('{"action":"close","symbol":"EURUSD"}',
          alert.freq_once_per_bar_close)

عندما يتقاطع متوسطان متحركان بسيطان (SMA) صعودًا تُفتح صفقة شراء ويُرسل JSON الشراء؛ وعندما يتقاطعان هبوطًا تُغلق الصفقة. ويمنع استخدام alert.freq_once_per_bar_close تكرار إطلاق التنبيه داخل شمعة لم تكتمل بعد — وهو سبب شائع للأوامر المكررة.

المشكلات الشائعة (أوامر إيقاف غير صالحة، أسماء الرموز، الحجم)

• اختلاف اسم الرمز. قد يدرج وسيطك EURUSD باسم EURUSD.m أو EURUSD.pro أو ما شابه. وإذا لم يطابق الرمز في JSON الاسم تمامًا، فلن يُعثر على الأداة. تحقق من الاسم الدقيق في نافذة Market Watch (مراقبة السوق) في MetaTrader 5.
• مستويات إيقاف غير صالحة. يُرفض وقف الخسارة إذا كان أعلى السعر في أمر شراء (أو أسفله في أمر بيع). كما يجب أن تحترم أوامر الإيقاف الحد الأدنى للمسافة عن السعر الحالي الذي يفرضه الوسيط («stops level»).
• رفض الحجم. صغير جدًا، أو كبير جدًا، أو بخطوة غير صحيحة (مثل 0.013 بينما لا يسمح الوسيط إلا بمضاعفات 0.01). ويطبّق etrink أيضًا حد الحجم الخاص بكل حساب — خفّض قيمة volume أو ارفع الحد.
• تنفيذ مكرر. إذا انطلق التنبيه مع كل تيك بدلًا من إغلاق الشمعة، فستفتح صفقات كثيرة. اضبط تكرار التنبيه على Once Per Bar Close.

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

هل أحتاج إلى VPS أو إلى إبقاء جهازي يعمل؟

لا. يرسل TradingView الـ webhook من خوادمه، ويستضيف etrink جانب MT5. يمكن أن يكون جهازك مطفأً.

هل يلزم اشتراك مدفوع في TradingView؟

روابط الـ webhook ميزة مدفوعة في TradingView، لذا نعم بالنسبة لجانب التنبيهات. أما التنفيذ على MT5 فيتولاه etrink.

هل يمكنني الاختبار دون المخاطرة بأموالي؟

نعم — أضف "test": true إلى أي رسالة، فتجري كل عمليات التحقق دون تنفيذ أي أمر حقيقي. راجع التوثيق لمزيد من التفاصيل.

هل يمكنني أتمتة ذلك برمجيًا؟

إذا كنت تفضّل التحكم في etrink من مساعد ذكاء اصطناعي أو من أدواتك الخاصة، فإن تكامل MCP لدينا يوفر الإجراءات نفسها.

ابدأ مجانًا — أنشئ حسابًا، واربط TradingView بمنصة MT5، وشغّل أول تنبيه مؤتمت لك ضمن الفترة التجريبية المجانية خلال دقائق. لديك أسئلة؟ [email protected]