حمولة webhook من TradingView

الهدف

توثق هذه الصفحة عقد WebhookIngress العام لتنبيهات TradingView. هذا ليس payload أوامر dashboard اليدوية.

مسار الوصول

• في مساحة العميل: حساباتي > افتح حساب تداول > انسخ مفتاح الوصول.
• في TradingView: Alert > Notifications > الصق https://webhook.theconnector.fr/YOUR_ACCESS_KEY في Webhook URL.
• في حقل Message داخل TradingView، الصق JSON.

JSON بسيط

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 20,
  "tp": 40
}

الحقول التي يقرأها WebhookIngress

• action إلزامي. الأسماء البديلة: side, type, command, msgtype.
• symbol إلزامي لأوامر التداول. الأسماء البديلة: pair, ticker, instrument, market, asset.
• risk يرسل كقيمة مخاطرة رقمية. للحجم الثابت استخدم volume, lot, lots أو fixedVolume.
• sl وtp هما الاسمان الحاليان لوقف الخسارة وجني الربح. الأسماء البديلة: stoploss, stop_loss, takeprofit, take_profit.
• price يستخدم فقط للأوامر المعلقة: buystop, buylimit, sellstop, selllimit.
• ticket, orderId, order_id, positionId أو position_id تستخدم فقط عند استهداف أمر أو مركز معروف.
• account / accountCode وplatform اختيارية مع رابط الحساب؛ تفيد فقط في مسارات routing مشتركة.
• يمكن إرسال streamId أو id للتتبع. إذا غاب، ينشئ الخادم معرّفاً.
• tag (الاسم البديل comment) يسمّي الاستراتيجية التي ينتمي إليها التنبيه. عند الدخول يُكتب في تعليق المركز لدى الوسيط؛ وعند الإغلاق يحصر الإغلاق في المراكز التي تحمل ذلك الاسم، فيمكن لعدة استراتيجيات مشاركة حساب واحد ورمز واحد. يُحوَّل إلى أحرف صغيرة ويُقتطع إلى 12 حرفاً، ويُطبَّق ابتداءً من الروبوت 0.0.21 — ودون ذلك يُرفض الإغلاق المُسمّى بدل تنفيذه على مركز استراتيجية أخرى. وإذا أرسلت streamId خاصاً بك فإنه يحلّ محل المُولَّد ولا يصل الاسم إلى تعليق المركز أبداً: احذف streamId عند استخدام الأسماء.
• يمكن إرسال clientRequestedAtUtc, requestedAtUtc أو requestedAt كوقت UTC للمعلومة.

بديل في سطر واحد

يوصى باستخدام JSON، لكن WebhookIngress يقبل أيضاً نصاً مفصولاً بفواصل:

buy,EURUSD,risk=1,sl=20,tp=40

ما لا ينبغي إرساله

لا تعتمد على ttl_ms, vol_lots, sl_pips أو tp_pips: parser الحالي في WebhookIngress لا يقرأ هذه الأسماء. استخدم وضع السعر في الحساب لتفسير sl, tp وprice.

سكربتات طرف ثالث موجودة

لا تفترض أن رسالة مخصصة لموصل آخر تعمل كما هي. يمكنك الاحتفاظ بمنطق الاستراتيجية، لكن تحقق من حقول TradingView أعلاه وعدّلها.