التعليمات
مع إطلاق بوت الإشارات في CoinW، يمكنك بسهولة تحويل استراتيجياتك على (TradingView (TV إلى أوامر تداول مباشرة تلقائية بالكامل تعمل على مدار الساعة كل أيام الأسبوع.
تم إعداد هذا الدليل خصيصًا للمستخدمين الذين يستخدمون استراتيجيات PineScript™ (سكربتات من نوع الإستراتيجية). سنرشدك خطوة بخطوة لكيفية إعداد رسائل التنبيه بلغة بسيطة وواضحة، بحيث يمكن حتى للمستخدمين الذين لا يمتلكون خلفية برمجية اتباعها بسهولة.
نظرة سريعة: هل تستخدم استراتيجية أم مؤشر؟
قبل البدء في الإعداد، يرجى التأكد من نوع السكربت الذي تستخدمه على TradingView:
الاستراتيجية (Strategy): يبدأ الكود بـ strategy(...) أو يحتوي على أوامر تنفيذ مثل strategy.entry. لا يقتصر دورها على إنشاء إشارات شراء وبيع على المخطط، بل يمكنها أيضًا إجراء اختبارات تاريخية (Backtesting) وحساب حجم المركز لكل صفقة تلقائيًا. (هذا الدليل مخصص لمستخدمي الاستراتيجيات).
المؤشر (Indicator): يبدأ الكود بـ indicator(...). يُستخدم فقط لتحليل المخطط ورسم الخطوط أو التنبيهات، ولا يتضمن حساب حجم المراكز. (إذا كنت تستخدم مؤشرًا، فإن المنصة لا تدعم التداول المبني على المؤشرات حاليًا).
الخطوة 1: نسخ قالب رسالة التنبيه
لمساعدتك على البدء بسرعة، عند إنشاء تنبيه على TradingView، قم بنسخ كود JSON التالي ولصقه في خانة “Message”.
تحذير تنسيقي: يرجى التأكد من الحفاظ على الأقواس المعقوفة {} وعلامات الاقتباس “” كما هي، وعدم حذف الفواصل.
الخطوة 2: شرح المعلمات (ما الذي يتم تغييره وما الذي يجب الإبقاء عليه)
الأجزاء الموجودة داخل {{ }} في القالب تُعد “عناصر نائبة قياسية” في TradingView. عند تفعيل الإشارة، سيقوم TradingView بملئها تلقائيًا ببيانات السوق الفعلية. لا تقم بتعديلها.
1. رسالة التنبيه – id
id – معرف الطلب
{{strategy.order.id}} يعرض معرف الطلب الذي تم تنفيذه (وهو النص المستخدم كأول معامل في دوال إنشاء الطلبات مثل strategy.entry أو strategy.exit أو strategy.order).
2. رسالة التنبيه – action
action – هل هي “شراء” أم “بيع”؟
{{strategy.order.action}} يعرض النص "buy" أو "sell" للطلب المنفذ.
3. رسالة التنبيه – marketPosition
marketPosition – حالة المركز المتوقعة (وقت تنفيذ الطلب)
{{strategy.market_position}} يعرض الحالة الحالية للمركز كنص: "long" أو "flat" أو "short".
4. رسالة التنبيه – prevMarketPosition
prevMarketPosition – حالة المركز السابقة (قبل تنفيذ الطلب)
{{strategy.prev_market_position}} يعرض الحالة السابقة للمركز كنص: "long" أو "flat" أو "short".
5. رسالة التنبيه – instrument
ticker – قيمة العنصر النائب في TradingView
“العنصر النائب القياسي” هو نص محاط بأقواس مزدوجة ويتم تضمينه في رسالة التنبيه.
{{ticker}} يعرض رمز المخطط الذي أنشأ التنبيه.
مثال: "BTCUSDT.P", "ETHUSDT.P".
6. رسالة التنبيه – signalToken
رمز الإشارة – توثيق الإشارة
يضمن هذا الإجراء الأمني أن الطلبات الواردة شرعية ومصرح بها. عند إنشاء إشارة جديدة بنجاح على CoinW، يتم إنشاء هذا الرمز تلقائيًا ويجب نسخه إلى رسالة التنبيه في TradingView.
الخطوة 3: كيفية إعداد حجم المركز وأنماط المضاعفة (الدليل الأساسي)
المعاملان investmentType و amount هما الأكثر أهمية، حيث يحددان مقدار الأموال التي سيستخدمها البوت عند كل إشارة تداول.
بناءً على أنماط التداول المختلفة، قمنا بتلخيص ثلاثة أوضاع إعداد شائعة:
الوضع 1: المزامنة الكاملة مع حجم مركز استراتيجية TradingView
يتم تفويض حساب حجم المركز بالكامل إلى سكربت TradingView. يقوم السكربت بحساب عدد العملات أو العقود لكل صفقة، ويقوم بوت CoinW بتنفيذها بنسبة 1:1 دون أي تعديل إضافي.
الإعداد:
"investmentType": "base" (يعني تنفيذ الأوامر بناءً على كمية العملة الأساسية)
"amount": "{{strategy.order.contracts}}" (يسمح لـ TradingView بملء كمية الطلب المحسوبة تلقائيًا)
هل يوجد مضاعفة؟ يعتمد ذلك على كيفية كتابة سكربت TradingView الخاص بك. أي منطق مضاعفة تستخدمه في الاستراتيجية سيتم تطبيقه بنفس الشكل تمامًا في البوت المباشر.
التوافق مع رمز واحد أو عدة رموز: هذا الوضع متوافق بشكل كامل مع التداول على رمز واحد أو عدة رموز. يقوم TradingView تلقائيًا بحساب الكمية لكل رمز بناءً على سعره. على سبيل المثال، لنفس 1,000 USDT، قد يقوم TradingView بحساب 0.01 BTC أو مئات الآلاف من عملة DOGE. يُعد هذا الوضع الأكثر أمانًا لتشغيل الاستراتيجيات متعددة الرموز. ولكن، يجب على المستخدم تحديد الهامش المناسب بناءً على إعدادات الرافعة المالية الخاصة به. على سبيل المثال، عند استخدام رافعة مالية 3x مقابل 20x، كيف يتم حساب الهامش لكل رمز؟
هذه نقطة شائعة يقع فيها العديد من المبتدئين. عند استخدام هذا الوضع، فإن التعليمات التي يرسلها TradingView إلى CoinW تكون فقط بعدد العملات المطلوب شراؤها. أما مقدار USDT الذي سيتم خصمه فعليًا من حسابك كهامش، فيعتمد بالكامل على الرافعة المالية التي قمت بتحديدها في صفحة التداول في CoinW.
المعادلة: الهامش الفعلي = (كمية العملات من TradingView × سعر العملة عند تفعيل الإشارة) ÷ الرافعة المالية
مثال عملي: افترض أن سعر BTC الحالي هو 60,000 USDT. قامت استراتيجية TradingView بإرسال إشارة شراء، وتم حساب كمية الطلب تلقائيًا لتكون 0.1 BTC. القيمة الإجمالية للمركز هي: 0.1 × 60,000 = 6,000 USDT ، كم تحتاج من رصيد متاح لتنفيذ الصفقة؟
السيناريو A: رافعة مالية منخفضة (3x)
الهامش = 6,000 ÷ 3 = 2,000 USDT
(يجب أن يحتوي حسابك على 2,000 USDT على الأقل، وإلا سيفشل التنفيذ بسبب عدم كفاية الهامش)
السيناريو B: رافعة مالية عالية (20x)
الهامش = 6,000 ÷ 20 = 300 USDT
(تحتاج فقط إلى 300 USDT، لكن مع مخاطر تصفية أعلى)
الوضع 2: تحديد حجم مركز ثابت
في كل مرة يتم فيها استقبال إشارة تداول، يتم استخدام مبلغ ثابت من USDT كهامش، بغض النظر عن حجم الأرباح في الحساب. تبقى الأرباح داخل الحساب، مما يساعد في التحكم بالمخاطر لكل صفقة.
الإعداد (مثال: 50 USDT لكل صفقة):
"investmentType": "margin" (يعني استخدام هامش ثابت)
"amount": "50" (أدخل رقمًا محددًا يمثل 50 USDT)
هل يوجد مضاعفة؟ لا. يتم استخدام 50 USDT في كل صفقة حتى لو تضاعف الحساب.
التوافق مع رمز واحد أو عدة رموز: متوافق مع جميع الرموز. سواء كانت الإشارة على BTC أو SHIB، سيتم استخدام 50 USDT فقط لكل صفقة، دون التأثر باختلاف الأسعار.
الوضع 3: نسبة من رصيد الحساب
في كل مرة يتم فيها استقبال إشارة تداول، يقوم النظام تلقائيًا بحساب الرصيد المتاح في حساب العقود الآجلة في CoinW، ويستخدم نسبة مئوية محددة منه كهامش.
الإعداد (مثال: استخدام 10% من الرصيد لكل صفقة):
"investmentType": "percentage_balance" (يعني استخدام نسبة من الرصيد)
"amount": "10" (أدخل رقمًا بين 0.01 و100، حيث 10 تعني 10%)
هل يوجد مضاعفة؟ نعم، يتم تطبيق المضاعفة تلقائيًا. إذا كان رأس المال الابتدائي 1,000 USDT، فستستخدم الصفقة الأولى 100 USDT. وإذا نما حسابك إلى 2,000 USDT بعد تحقيق أرباح، فستستخدم الصفقة التالية تلقائيًا 200 USDT، مما يسمح بتراكم الأرباح. وعلى العكس، إذا تكبدت خسائر، سينخفض حجم الصفقة لكل مرة وفقًا لذلك، مما يساعد على تقليل مخاطر التصفية.
التوافق مع رمز واحد أو عدة رموز: ممتاز للاستراتيجيات على رمز واحد. يجب استخدامه بحذر في الاستراتيجيات متعددة الرموز. إذا كنت تستخدم هذا الوضع مع عدة رموز، فيجب ضبط نسبة منخفضة (على سبيل المثال 2%). خلاف ذلك، في ظروف السوق المتقلبة حيث يتم تفعيل إشارات متعددة في نفس الوقت، قد يتم استهلاك كامل رصيدك المتاح، مما يؤدي إلى فشل بعض الإشارات في التنفيذ.
تنبيه لتجنب الأخطاء: إذا كنت تستخدم استراتيجية متعددة الرموز، لا تقم أبدًا باستخدام investmentType = base مع قيمة ثابتة للـ amount مثل ( "amount": "10"). شراء 10 BTC يتطلب مئات الآلاف من USDT، بينما شراء 10 SHIB قد لا يفي بالحد الأدنى للطلب. هذا سيؤدي إلى أخطاء متكررة.
تنبيه أمني: رمز signalToken هو بمثابة كلمة مرور التداول المباشر. يجب الحفاظ عليه بسرية تامة. لا تشارك لقطات شاشة له في المجتمعات العامة مثل WeChat أو تيليغرام. في حال تسريبه، قد يتم استخدامه لإرسال إشارات ضارة والتحكم في حسابك. إذا شككت في اختراقه، قم بحذف البوت فورًا وإنشاء واحد جديد.
مع إطلاق بوت الإشارات في CoinW، يمكنك بسهولة تحويل استراتيجياتك على (TradingView (TV إلى أوامر تداول مباشرة تلقائية بالكامل تعمل على مدار الساعة كل أيام الأسبوع.
تم إعداد هذا الدليل خصيصًا للمستخدمين الذين يستخدمون استراتيجيات PineScript™ (سكربتات من نوع الإستراتيجية). سنرشدك خطوة بخطوة لكيفية إعداد رسائل التنبيه بلغة بسيطة وواضحة، بحيث يمكن حتى للمستخدمين الذين لا يمتلكون خلفية برمجية اتباعها بسهولة.
نظرة سريعة: هل تستخدم استراتيجية أم مؤشر؟
قبل البدء في الإعداد، يرجى التأكد من نوع السكربت الذي تستخدمه على TradingView:
الاستراتيجية (Strategy): يبدأ الكود بـ strategy(...) أو يحتوي على أوامر تنفيذ مثل strategy.entry. لا يقتصر دورها على إنشاء إشارات شراء وبيع على المخطط، بل يمكنها أيضًا إجراء اختبارات تاريخية (Backtesting) وحساب حجم المركز لكل صفقة تلقائيًا. (هذا الدليل مخصص لمستخدمي الاستراتيجيات).
المؤشر (Indicator): يبدأ الكود بـ indicator(...). يُستخدم فقط لتحليل المخطط ورسم الخطوط أو التنبيهات، ولا يتضمن حساب حجم المراكز. (إذا كنت تستخدم مؤشرًا، فإن المنصة لا تدعم التداول المبني على المؤشرات حاليًا).
الخطوة 1: نسخ قالب رسالة التنبيه
لمساعدتك على البدء بسرعة، عند إنشاء تنبيه على TradingView، قم بنسخ كود JSON التالي ولصقه في خانة “Message”.
تحذير تنسيقي: يرجى التأكد من الحفاظ على الأقواس المعقوفة {} وعلامات الاقتباس “” كما هي، وعدم حذف الفواصل.
الخطوة 2: شرح المعلمات (ما الذي يتم تغييره وما الذي يجب الإبقاء عليه)
الأجزاء الموجودة داخل {{ }} في القالب تُعد “عناصر نائبة قياسية” في TradingView. عند تفعيل الإشارة، سيقوم TradingView بملئها تلقائيًا ببيانات السوق الفعلية. لا تقم بتعديلها.
1. رسالة التنبيه – id
id – معرف الطلب
{{strategy.order.id}} يعرض معرف الطلب الذي تم تنفيذه (وهو النص المستخدم كأول معامل في دوال إنشاء الطلبات مثل strategy.entry أو strategy.exit أو strategy.order).
2. رسالة التنبيه – action
action – هل هي “شراء” أم “بيع”؟
{{strategy.order.action}} يعرض النص "buy" أو "sell" للطلب المنفذ.
3. رسالة التنبيه – marketPosition
marketPosition – حالة المركز المتوقعة (وقت تنفيذ الطلب)
{{strategy.market_position}} يعرض الحالة الحالية للمركز كنص: "long" أو "flat" أو "short".
4. رسالة التنبيه – prevMarketPosition
prevMarketPosition – حالة المركز السابقة (قبل تنفيذ الطلب)
{{strategy.prev_market_position}} يعرض الحالة السابقة للمركز كنص: "long" أو "flat" أو "short".
5. رسالة التنبيه – instrument
ticker – قيمة العنصر النائب في TradingView
“العنصر النائب القياسي” هو نص محاط بأقواس مزدوجة ويتم تضمينه في رسالة التنبيه.
{{ticker}} يعرض رمز المخطط الذي أنشأ التنبيه.
مثال: "BTCUSDT.P", "ETHUSDT.P".
6. رسالة التنبيه – signalToken
رمز الإشارة – توثيق الإشارة
يضمن هذا الإجراء الأمني أن الطلبات الواردة شرعية ومصرح بها. عند إنشاء إشارة جديدة بنجاح على CoinW، يتم إنشاء هذا الرمز تلقائيًا ويجب نسخه إلى رسالة التنبيه في TradingView.
الخطوة 3: كيفية إعداد حجم المركز وأنماط المضاعفة (الدليل الأساسي)
المعاملان investmentType و amount هما الأكثر أهمية، حيث يحددان مقدار الأموال التي سيستخدمها البوت عند كل إشارة تداول.
بناءً على أنماط التداول المختلفة، قمنا بتلخيص ثلاثة أوضاع إعداد شائعة:
الوضع 1: المزامنة الكاملة مع حجم مركز استراتيجية TradingView
يتم تفويض حساب حجم المركز بالكامل إلى سكربت TradingView. يقوم السكربت بحساب عدد العملات أو العقود لكل صفقة، ويقوم بوت CoinW بتنفيذها بنسبة 1:1 دون أي تعديل إضافي.
الإعداد:
"investmentType": "base" (يعني تنفيذ الأوامر بناءً على كمية العملة الأساسية)
"amount": "{{strategy.order.contracts}}" (يسمح لـ TradingView بملء كمية الطلب المحسوبة تلقائيًا)
هل يوجد مضاعفة؟ يعتمد ذلك على كيفية كتابة سكربت TradingView الخاص بك. أي منطق مضاعفة تستخدمه في الاستراتيجية سيتم تطبيقه بنفس الشكل تمامًا في البوت المباشر.
التوافق مع رمز واحد أو عدة رموز: هذا الوضع متوافق بشكل كامل مع التداول على رمز واحد أو عدة رموز. يقوم TradingView تلقائيًا بحساب الكمية لكل رمز بناءً على سعره. على سبيل المثال، لنفس 1,000 USDT، قد يقوم TradingView بحساب 0.01 BTC أو مئات الآلاف من عملة DOGE. يُعد هذا الوضع الأكثر أمانًا لتشغيل الاستراتيجيات متعددة الرموز. ولكن، يجب على المستخدم تحديد الهامش المناسب بناءً على إعدادات الرافعة المالية الخاصة به. على سبيل المثال، عند استخدام رافعة مالية 3x مقابل 20x، كيف يتم حساب الهامش لكل رمز؟
هذه نقطة شائعة يقع فيها العديد من المبتدئين. عند استخدام هذا الوضع، فإن التعليمات التي يرسلها TradingView إلى CoinW تكون فقط بعدد العملات المطلوب شراؤها. أما مقدار USDT الذي سيتم خصمه فعليًا من حسابك كهامش، فيعتمد بالكامل على الرافعة المالية التي قمت بتحديدها في صفحة التداول في CoinW.
المعادلة: الهامش الفعلي = (كمية العملات من TradingView × سعر العملة عند تفعيل الإشارة) ÷ الرافعة المالية
مثال عملي: افترض أن سعر BTC الحالي هو 60,000 USDT. قامت استراتيجية TradingView بإرسال إشارة شراء، وتم حساب كمية الطلب تلقائيًا لتكون 0.1 BTC. القيمة الإجمالية للمركز هي: 0.1 × 60,000 = 6,000 USDT ، كم تحتاج من رصيد متاح لتنفيذ الصفقة؟
السيناريو A: رافعة مالية منخفضة (3x)
الهامش = 6,000 ÷ 3 = 2,000 USDT
(يجب أن يحتوي حسابك على 2,000 USDT على الأقل، وإلا سيفشل التنفيذ بسبب عدم كفاية الهامش)
السيناريو B: رافعة مالية عالية (20x)
الهامش = 6,000 ÷ 20 = 300 USDT
(تحتاج فقط إلى 300 USDT، لكن مع مخاطر تصفية أعلى)
الوضع 2: تحديد حجم مركز ثابت
في كل مرة يتم فيها استقبال إشارة تداول، يتم استخدام مبلغ ثابت من USDT كهامش، بغض النظر عن حجم الأرباح في الحساب. تبقى الأرباح داخل الحساب، مما يساعد في التحكم بالمخاطر لكل صفقة.
الإعداد (مثال: 50 USDT لكل صفقة):
"investmentType": "margin" (يعني استخدام هامش ثابت)
"amount": "50" (أدخل رقمًا محددًا يمثل 50 USDT)
هل يوجد مضاعفة؟ لا. يتم استخدام 50 USDT في كل صفقة حتى لو تضاعف الحساب.
التوافق مع رمز واحد أو عدة رموز: متوافق مع جميع الرموز. سواء كانت الإشارة على BTC أو SHIB، سيتم استخدام 50 USDT فقط لكل صفقة، دون التأثر باختلاف الأسعار.
الوضع 3: نسبة من رصيد الحساب
في كل مرة يتم فيها استقبال إشارة تداول، يقوم النظام تلقائيًا بحساب الرصيد المتاح في حساب العقود الآجلة في CoinW، ويستخدم نسبة مئوية محددة منه كهامش.
الإعداد (مثال: استخدام 10% من الرصيد لكل صفقة):
"investmentType": "percentage_balance" (يعني استخدام نسبة من الرصيد)
"amount": "10" (أدخل رقمًا بين 0.01 و100، حيث 10 تعني 10%)
هل يوجد مضاعفة؟ نعم، يتم تطبيق المضاعفة تلقائيًا. إذا كان رأس المال الابتدائي 1,000 USDT، فستستخدم الصفقة الأولى 100 USDT. وإذا نما حسابك إلى 2,000 USDT بعد تحقيق أرباح، فستستخدم الصفقة التالية تلقائيًا 200 USDT، مما يسمح بتراكم الأرباح. وعلى العكس، إذا تكبدت خسائر، سينخفض حجم الصفقة لكل مرة وفقًا لذلك، مما يساعد على تقليل مخاطر التصفية.
التوافق مع رمز واحد أو عدة رموز: ممتاز للاستراتيجيات على رمز واحد. يجب استخدامه بحذر في الاستراتيجيات متعددة الرموز. إذا كنت تستخدم هذا الوضع مع عدة رموز، فيجب ضبط نسبة منخفضة (على سبيل المثال 2%). خلاف ذلك، في ظروف السوق المتقلبة حيث يتم تفعيل إشارات متعددة في نفس الوقت، قد يتم استهلاك كامل رصيدك المتاح، مما يؤدي إلى فشل بعض الإشارات في التنفيذ.
تنبيه لتجنب الأخطاء: إذا كنت تستخدم استراتيجية متعددة الرموز، لا تقم أبدًا باستخدام investmentType = base مع قيمة ثابتة للـ amount مثل ( "amount": "10"). شراء 10 BTC يتطلب مئات الآلاف من USDT، بينما شراء 10 SHIB قد لا يفي بالحد الأدنى للطلب. هذا سيؤدي إلى أخطاء متكررة.
تنبيه أمني: رمز signalToken هو بمثابة كلمة مرور التداول المباشر. يجب الحفاظ عليه بسرية تامة. لا تشارك لقطات شاشة له في المجتمعات العامة مثل WeChat أو تيليغرام. في حال تسريبه، قد يتم استخدامه لإرسال إشارات ضارة والتحكم في حسابك. إذا شككت في اختراقه، قم بحذف البوت فورًا وإنشاء واحد جديد.