مرجع صيغة الأوامر

الهدف

يسرد هذا المرجع الأوامر والأسماء البديلة التي يقبلها WebhookIngress. يصف مدخلات webhook من TradingView وليس أوامر dashboard اليدوية.

أوامر market وpending

• buy يقبل أيضاً long.
• sell يقبل أيضاً short.
• buystop يقبل أيضاً buy_stop.
• buylimit يقبل أيضاً buy_limit.
• sellstop يقبل أيضاً sell_stop.
• selllimit يقبل أيضاً sell_limit.
• يمكن أن يحمل الأمر المعلق expiration، مدة صلاحيته بالدقائق (الروبوت 0.0.30 أو أحدث): راجع صفحة صيغة الـ webhook.

إغلاق وإلغاء وتعديل

• closelong يقبل أيضاً close_long.
• closeshort يقبل أيضاً close_short.
• closelongshort يقبل أيضاً close_long_short.
• cancellong يقبل أيضاً cancel_long.
• cancelshort يقبل أيضاً cancel_short.
• newsltplong يقبل newsltp_long, breakevenlong, breakeven_long, break_even_long.
• newsltpshort يقبل newsltp_short, breakevenshort, breakeven_short, break_even_short.

أوامر موسّعة

السكربتات التي تستخدم هذه الأوامر وأسماء المعاملات مسبقًا تعمل هنا دون تعديل. تُترجم تلقائيًا الأسماء sl_pips وsl_price وsl_pct وtp_pips وtp_price وtp_pct وentry_pips وentry_price وvol_lots، ويقبل كل أمر أيضًا صيغته بالشرطة السفلية (close_all، newsltp_buy_stop، ...). باستثناء حالة واحدة: التنبيه الذي يخلط وحدات السعر (sl_pips مع tp_price مثلًا) يُرفض الآن.

• الخروج ثم الدخول في تنبيه واحد: closelongopenlong، closelongopenshort، closeshortopenlong، closeshortopenshort، closelongshortopenlong، closelongshortopenshort، cancellongbuystop، cancellongbuylimit، cancelshortsellstop، cancelshortselllimit.
• إغلاق كل شيء: closeall يغلق كل المراكز ويحذف كل الأوامر المعلّقة على جميع الرموز. وclosealleaoff يفعل الشيء نفسه ثم يوقف الروبوت مؤقتًا.
• إغلاق جزئي: closelongpct وcloseshortpct. تأتي النسبة من إعداد الحساب إغلاق جزئي (%) — هذه التنبيهات لا تحملها. وتبقى الأولوية لـ volume إن ورد في التنبيه.
• وقف/هدف على أمر معلّق: newsltpbuystop، newsltpbuylimit، newsltpsellstop، newsltpselllimit. لا تحرّك سعر الدخول أبدًا.
• الإيقاف/الاستئناف من تنبيه: eaoff، eaon. النطاق هو الحساب بأكمله.
• الوقف المتحرك على مركز واحد: trailingoff، trailingon، مع ticket الأمر. لا يتحرك الوقف الموجود؛ يتوقف الروبوت فقط عن تحريكه.
• الحجم المكتوب في التنبيه: vol_dollar (المبلغ المخاطر به بعملة الحساب)، vol_pct_bal_loss (% من الرصيد)، vol_pct_eq_loss (% من حقوق الملكية)، vol_pct_bal_margin (% من الرصيد كهامش — حد للانكشاف يتجاهل مسافة الوقف). التنبيه له الأولوية على إعدادات مخاطر الحساب.
• الحماية المكتوبة في التنبيه: spread يحدّ السبريد المقبول عند الدخول، بالنقاط. betrigger / beoffset ينقلان الوقف إلى نقطة التعادل؛ trailtrig / traildist / trailstep تحرّكه — الخمسة بالنقاط، على هذا المركز وحده. atrtimeframe / atrperiod / atrmultiplier / atrshift / atrtrigger تحرّكه بمضاعف ATR بدلاً من ذلك. تعمل حتى لو كان الوقف المتحرك للحساب مُطفأً.
• إصدار الروبوت: الحجم والحماية لكل تنبيه يتطلبان الروبوت 0.0.21 أو أحدث. الإصدارات الأقدم تتجاهلها وتنفّذ التنبيه بإعدادات الحساب.

عدة استراتيجيات على الرمز نفسه

استراتيجيتان تتداولان الزوج نفسه تعيشان على حساب واحد، لذا فإن closelong بلا اسم يغلق أول شراء يجده — وقد يكون مركز الاستراتيجية الأخرى. سمِّ كل استراتيجية بـ tag (الاسم البديل comment) للفصل بينهما: عند الدخول يكتب الروبوت ذلك الاسم في تعليق المركز لدى الوسيط، والإغلاق المُسمّى لا يمسّ سوى المراكز التي تحمله.

• ضع الاسم نفسه في كل تنبيهات الاستراتيجية، الدخول والخروج معاً. إغلاق باسم لم يظهر قط عند الدخول لا يغلق شيئاً.
• تُحوّل الأسماء إلى أحرف صغيرة وتُقتطع إلى 12 حرفاً، ويُحذف كل ما عدا الحروف والأرقام و- و_. لذا فإن Strat A وstrata هما الاسم نفسه — اختر أسماء قصيرة ومتمايزة.
• يتطلب الإغلاق المُسمّى الروبوت 0.0.21 أو أحدث. ومع روبوت أقدم يُرفض التنبيه بدل تنفيذه على مركز استراتيجية أخرى.
• يتبع الاسمُ تكرارَ الإشارات: المراكز المكرَّرة على حساب الهدف تحمل اسم المصدر.
• لا ترسل streamId خاصاً بك مع الاسم — فهو يحلّ محل المُولّد، وعندها لا يصل الاسم إلى تعليق المركز.
• وبدون اسم لا يتغير شيء: يبقى الإغلاق يأخذ أول مركز في الاتجاه المطلوب.

تنبيه الدخول لاستراتيجية trend:

{"action":"buy","symbol":"USDJPY","risk":1,"tag":"trend"}

وتنبيه الخروج الخاص بها، الذي لا يمسّ الاستراتيجية الأخرى:

{"action":"closelong","symbol":"USDJPY","tag":"trend"}

مثال market

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

يحدد priceMode وحدة sl وtp وprice داخل التنبيه نفسه: price أو pips أو percent. هنا يكون الوقف على بُعد 0.2% من سعر الدخول والهدف على بُعد 0.4%، أياً كان وضع السعر في الحساب؛ ومن دون priceMode يُطبَّق وضع السعر في الحساب.

مثال pending

{
  "action": "buystop",
  "symbol": "EURUSD",
  "price": 1.0875,
  "risk": 1,
  "sl": 1.0840,
  "tp": 1.0940,
  "priceMode": "price"
}

مثال إغلاق

{
  "action": "closelong",
  "symbol": "EURUSD",
  "ticket": "123456789"
}

ملاحظات parser

• يوضع المفتاح في Webhook URL: https://webhook.theconnector.fr/YOUR_ACCESS_KEY.
• risk رقم؛ للحجم الثابت استخدم volume, lot, lots أو fixedVolume.
• price مطلوب فقط للأوامر المعلقة.
• ttl_ms لا يقرأه parser الحالي. يحتفظ كل سعر بالوحدة التي كُتب بها — اللاحقة (sl_pips وtp_price…) لتلك القيمة وحدها، وإلا priceMode، وإلا وضع السعر في الحساب — ويُرفض التنبيه الذي تحتاج أسعاره إلى وحدتين (sl_pips مع tp_price مثلًا)، ولا يُرسل أبدًا دون وقف الخسارة أو جني الربح: ضع لاحقة على كل الأسعار، أو لا تضعها على أي منها.
• الأمر المتأخر ينتهي ولا يعاد تشغيله.