صيغة الإشارة

يقبل Signalync صيغتين للحمولة: سلسلة مختصرة بصيغة key=value مفصولة بفواصل، وكائن JSON قياسي. تُرسل كلتاهما إلى نقطة الاستقبال نفسها، POST /api/inbound/{sourceAuthKey}، وتنتجان داخليًا الإشارة الموحّدة نفسها.

الصيغة المفصولة بفواصل مثالية لرسائل تنبيهات TradingView لأنها قصيرة وسهلة الكتابة، وستعمل بالطريقة نفسها مع مصدر بوت Telegram عند إطلاقه. أما صيغة JSON فهي صريحة ومحددة الأنواع، وستكون الخيار الطبيعي لمصدر REST API عند إطلاقه. كل معامل متاح في إحدى الصيغتين متاح في الأخرى أيضًا. الحقلان المطلوبان كحد أدنى في كلتا الصيغتين هما symbol وaction، وكل ما عداهما اختياري.

شراء أساسي مع وقف الخسارة وجني الأرباح

EURUSD,buy,vol=0.1,sl_pips=50,tp_pips=100

بيع مع تحديد الحجم حسب المخاطرة وجني أرباح متعدد المستويات

XAUUSD,sell,vol_pctbal_loss=1,sl_pips=40,tp1_pips=40,tp2_pips=80,tp3_pips=120

أمر Buy Limit معلّق

EURUSD,buylimit,entry_price=1.0750,vol=0.2,sl_pips=30,tp_pips=90

وقف متحرك مع نقطة التعادل

GBPUSD,sell,vol_dollar=100,sl_pips=40,tp_pips=120,trail_trigger=30,trail_distance=15,be_trigger=20

الإشارة نفسها بصيغة JSON

{
  "symbol": "EURUSD",
  "action": "buy",
  "volume": 0.1,
  "volumeType": "lots",
  "sl": 50,
  "slType": "pips",
  "tp": 100,
  "tpType": "pips",
  "comment": "MyStrategy"
}

كل الحقول التي يقبلها محلّل الإشارات. استخدم اسم المعامل في الصيغة المفصولة بفواصل داخل الإشارات النصية، ومفتاح JSON عند الإرسال بصيغة JSON.

سبعة معاملات للحجم تمنحك تحكمًا كاملًا في تحديد حجم المركز. ينبغي تحديد معامل واحد فقط منها في كل إشارة.

لوتات ثابتة

vol=0.1 أو vol_lots=0.1: تداول 0.1 لوت بالضبط بغض النظر عن رصيد الحساب.

EURUSD,buy,vol=0.1,sl_pips=50,tp_pips=100

نسبة مئوية من الرصيد

vol_pctbal=2: يحسب الموصّل عدد اللوتات بحيث تُستخدم 2% من رصيد الحساب كقيمة اسمية للمركز. لا يتطلب وقف خسارة.

EURUSD,buy,vol_pctbal=2,tp_pips=80

تحديد الحجم حسب المخاطرة

تحسب المعاملات vol_dollar=100 وvol_pctbal_loss=2 وvol_pcteq_loss=1 جميعها حجم اللوت من أقصى خسارة مقبولة في الصفقة. الثلاثة كلها تتطلب وقف خسارة (sl_pips أو sl_price أو sl_percent) حتى يتمكن الموصّل من حساب المسافة إلى الوقف.

EURUSD,buy,vol_pctbal_loss=1,sl_pips=30,tp_pips=90

يمكن تحديد كل من وقف الخسارة وجني الأرباح بثلاث طرق: بالنقاط، أو بسعر محدد، أو بنسبة مئوية من سعر الدخول. ويمكن الجمع بحرية بين المتغيرات الستة (ثلاثة لوقف الخسارة وثلاثة لجني الأرباح).

جني الأرباح متعدد المستويات

استخدم tp1 وtp2 وtp3 (بعدد غير محدود من المستويات) لإغلاق أجزاء من المركز عند أهداف مختلفة. تُورَّث لاحقة النوع (_pips أو _price) من tp1 إذا حُذفت في المستويات التالية.

# All three levels interpreted as pips (type inherited from tp1)
EURUSD,buy,vol_pctbal_loss=2,sl_pips=30,tp1_pips=50,tp2=100,tp3=150,pct1=50,pct2=30,pct3=20

استخدم إجراء أمر معلّق عندما تريد من الوسيط وضع أمر عند سعر مستقبلي وليس سعر السوق الحالي. الإجراءات المعلّقة الأربعة هي buylimit وselllimit وbuystop وsellstop، وكلها تتطلب سعر دخول.

معامل الدخول

حدد أين يجب وضع الأمر المعلّق باستخدام أحد معاملات الدخول:

# Entry at an absolute price
EURUSD,buylimit,entry_price=1.0750,vol=0.2,sl_pips=30,tp_pips=90

# Entry X pips from the current price
GBPUSD,sellstop,entry_pips=40,vol=0.1,sl_pips=25,tp_pips=75

علامتا ExOp و ExEnt

تغيّر علامتان طريقة التعامل مع المراكز المفتوحة عند وصول إشارة أمر جديدة:

• exop، الخروج من الاتجاه المعاكس (Exit Opposite): إغلاق أي مراكز في الاتجاه المعاكس قبل وضع الأمر الجديد. لا يفتح المركز الجديد إذا كانت توجد مراكز معاكسة.
• exent، الخروج ثم الدخول (Exit and Enter): إغلاق المراكز المعاكسة ثم فتح المركز الجديد.

# Close any open longs, then open a buy
EURUSD,buy,vol=0.1,sl_pips=50,tp_pips=100,exent,comment=TrendFollow

أضف وقفًا متحركًا أو نقلًا إلى نقطة التعادل لأي أمر بسعر السوق بإضافة المعاملات ذات الصلة. سيتولى موصّل Signalync الإدارة المستمرة على جانب MT5 بعد وضع الأمر.

الوقف المتحرك

يتفعّل الوقف المتحرك عندما تصل الصفقة إلى ربح قدره trail_trigger نقطة، ثم يحرّك وقف الخسارة على بعد trail_distance نقطة خلف السعر الحالي. ويمنع المعامل الاختياري trail_step الوقف من التحرك مع كل تغير لحظي في السعر: فهو لا ينتقل إلا عندما يتحرك السعر trail_step نقطة على الأقل.

GBPUSD,sell,vol=0.1,sl_pips=40,tp_pips=120,trail_trigger=30,trail_distance=15,trail_step=5

نقطة التعادل

ينقل إجراء نقطة التعادل وقف الخسارة إلى سعر الدخول (مع إمكانية تثبيت be_offset نقطة من الربح) عندما تصل الصفقة إلى ربح قدره be_trigger نقطة.

EURUSD,buy,vol_pctbal_loss=1,sl_pips=30,tp_pips=90,be_trigger=20,be_offset=2

لإغلاق جزء من مركز مفتوح، استخدم أحد إجراءات الإغلاق (closebuy أو closesell أو closeall) مع المعامل pct أو pct_lots.

# Close 50% of all open buy positions on XAUUSD
XAUUSD,closebuy,pct=50

# Close exactly 0.5 lots of sell positions, filtered by comment
EURUSD,closesell,pct_lots=0.5,comment=ScalpStrategy

بدون المعامل pct أو pct_lots، يغلق إجراء الإغلاق المركز بأكمله.

تتم مصادقة كل طلب وارد بمفتاح مصادقة المصدر المضمّن في URL. ويضيف سر HMAC الاختياري طبقة تحقق ثانية عبر ترويسة الطلب.

• مفتاح URL: POST /api/inbound/{sourceAuthKey}. يُنشأ مفتاح المصادقة عند إنشائك مصدرًا، وهو بمثابة بيانات الاعتماد الأساسية. حافظ على سريته.
• سر HMAC (اختياري): إذا كان للمصدر سر مضبوط، فيجب أن يتضمن كل طلب ترويسة X-Signalync-Secret. تُرفض الطلبات التي لا تحمل ترويسة مطابقة مع 401 HMAC_MISMATCH.