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

الهدف

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

أوامر market وpending

• buy يقبل أيضاً long.
• sell يقبل أيضاً short.
• buystop يقبل أيضاً buy_stop.
• buylimit يقبل أيضاً buy_limit.
• sellstop يقبل أيضاً sell_stop.
• selllimit يقبل أيضاً sell_limit.

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

• 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.

أوامر متوافقة مع PineConnector

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

• الخروج ثم الدخول في تنبيه واحد: closelongopenlong، closelongopenshort، closeshortopenlong، closeshortopenshort، closelongshortopenlong، closelongshortopenshort، cancellongbuystop، cancellongbuylimit، cancelshortsellstop، cancelshortselllimit.
• إغلاق كل شيء: closeall يغلق كل المراكز ويحذف كل الأوامر المعلّقة على جميع الرموز. وclosealleaoff يفعل الشيء نفسه ثم يوقف الروبوت مؤقتًا.
• إغلاق جزئي: closelongpct وcloseshortpct. تأتي النسبة من إعداد الحساب إغلاق جزئي (%) — هذه التنبيهات لا تحملها، ولا تنبيهات PineConnector. وتبقى الأولوية لـ 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": 20,
  "tp": 40
}

مثال pending

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

مثال إغلاق

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

ملاحظات parser

• يوضع المفتاح في Webhook URL: https://webhook.theconnector.fr/YOUR_ACCESS_KEY.
• risk رقم؛ للحجم الثابت استخدم volume, lot, lots أو fixedVolume.
• price مطلوب فقط للأوامر المعلقة.
• ttl_ms, vol_lots, sl_pips وtp_pips لا يقرأها parser الحالي.
• الأمر المتأخر ينتهي ولا يعاد تشغيله.