دليل المستخدم — إعداد وإدارة الرافعة المالية العالمية

نظرة عامة

يشرح هذا الدليل كيفية استخدام خيارات تكوين الرافعة المالية في tradesettings.yaml ضمن الإعدادات العامة لإدارة الرافعة المالية عبر جميع رموز التداول في بورصتك.

1. SetLeverageStartup

SetLeverageStartup: false

الغرض: تطبيق الرافعة المالية المحددة على جميع رموز التداول عند بدء تشغيل البوت.

متى يتم التفعيل (true)

• ✅ الإعداد الأولي: عند الحاجة إلى تعيين الرافعة المالية لجميع الرموز في البداية
• ✅ بعد تغيير إعدادات الرافعة المالية: عندما تقوم بتعديل الرافعة المالية المطلوبة
• ✅ بعد إضافة رموز جديدة: عند إضافة أزواج تداول جديدة إلى البورصة

متى يتم التعطيل (false)

• ✅ بعد تحديث الرافعة المالية بنجاح: لتجنب استدعاءات API غير الضرورية
• ✅ التشغيل العادي: لمنع إعادة تعيين الرافعة المالية في كل إعادة تشغيل
• ✅ عندما تكون الرافعة المالية قد تم تهيئتها بالفعل: إذا كانت جميع الرموز لديها الرافعة المالية الصحيحة

⚠️ ملاحظات هامة

• قم دائمًا بتعيين false بعد تحديث الرافعة المالية بنجاح لتجنب:
  • استدعاءات API غير ضرورية في كل تهيئة
  • الحدود المحتملة للمعدل من البورصة
  • أوقات بدء تشغيل أبطأ

# الخطوة 1: التفعيل لتحديث الرافعة المالية
SetLeverageStartup: true

# الخطوة 2: تشغيل البوت (سيتم تطبيق الرافعة المالية)
# الخطوة 3: إيقاف البوت

# الخطوة 4: التعطيل قبل التشغيل التالي
SetLeverageStartup: false

مثال على سير العمل

1. قم بتعيين الرافعة المالية المطلوبة في التكوين (مثل 10x)
2. فعّل SetLeverageStartup: true
3. ابدأ البوت → تطبيق الرافعة المالية على جميع الرموز
4. أوقف البوت
5. قم بتعطيل SetLeverageStartup: false
6. أعد تشغيل البوت للتداول العادي

2. SetMaxLeverage

SetMaxLeverage: false

الغرض: استخدام الرافعة المالية القصوى المسموح بها من البورصة لكل رمز تلقائيًا بدلاً من القيمة المكونة للرافعة المالية.

كيفية العمل

عندما يكون false (الافتراضي):

• يستخدم قيمة الرافعة المالية المكونة لجميع الرموز
• إذا لم يكن مدعومًا، قد تفشل استدعاءات API

عندما يكون true:

• يجلب الرافعة المالية القصوى المدعومة لكل رمز
• يستخدم القيمة الأقل بين المكونة والحد الأقصى للبورصة

سيناريوهات مثالية

# السيناريو 1: الرمز يدعم رافعتك المالية
تكوينك: 20x
الحد الأقصى للرمز: 50x
النتيجة: 20x

# السيناريو 2: الرمز لديه رافعة مالية قصوى أقل
تكوينك: 20x
الحد الأقصى للرمز: 5x
النتيجة: 5x
إخراج البوت: "ℹ️ الحد الأقصى للرافعة المالية لـ XYZUSDT هو 5x، يتم استخدام 5x بدلاً من 20x"

# السيناريو 3: الرمز لديه رافعة مالية قصوى أعلى
تكوينك: 10x
الحد الأقصى للرمز: 125x
النتيجة: 10x

متى يتم التفعيل (true)

• ✅ نهج آمن لتجنب الأخطاء المتعلقة بالرافعة المالية
• ✅ أنواع رموز مختلطة مع حدود رافعة مالية متغيرة
• ✅ تداول محافظ للتكيف التلقائي مع الحدود
• ✅ بوتات متعددة البورصات مع قواعد مختلفة

متى يتم التعطيل (false)

• ✅ رافعة مالية موحدة مدعومة عبر جميع الرموز
• ✅ الاستراتيجية تتطلب قيم رافعة مالية دقيقة
• ✅ تحسين الأداء (استدعاءات API أقل)

التكامل مع symbols.json

تدفق تحديث الرافعة المالية

1. يقرأ البوت الرافعة المالية من tradesettings.yaml
2. إذا كان SetMaxLeverage: true → يجلب الرافعة المالية القصوى
3. يحسب الرافعة المالية النهائية (الحد الأدنى بين المكونة والقصوى)
4. يطبق الرافعة المالية عبر واجهة برمجة التطبيقات (API) للبورصة
5. ✅ يحدث symbols.json بالرافعة المالية المطبقة فعليًا
6. يستخدم البوت الرافعة المالية من symbols.json للتداول

لماذا يهم تحديث symbols.json

• يضمن الاتساق مع البورصة
• يستمر عبر إعادات التشغيل
• تتبع مرئي للرافعة المالية المستخدمة فعليًا

⚠️ هام: توقيت المزامنة

# ❌ الطريقة الخاطئة
SetLeverageStartup: true
SetMaxLeverage: true

# ✅ الطريقة الصحيحة (تحديث لمرة واحدة)
SetLeverageStartup: true
SetMaxLeverage: true
# بعد النجاح:
SetLeverageStartup: false
SetMaxLeverage: false

سير العمل الموصى به للتكوين

الإعداد الأولي (بوت جديد)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true

1. تهيئة الإعدادات أعلاه
2. تشغيل البوت → تطبيق الرافعة المالية وتحديث symbols.json
3. إيقاف البوت
4. تعطيل كلا الإعدادين
5. إعادة التشغيل للتشغيل العادي

تغيير قيمة الرافعة المالية

# tradesettings.yaml
Leverage: 15
SetLeverageStartup: true
SetMaxLeverage: true

1. تحديث قيمة الرافعة المالية
2. تفعيل SetLeverageStartup
3. تشغيل البوت → تطبيق الرافعة المالية الجديدة
4. إيقاف البوت
5. تعطيل مرة أخرى قبل التشغيل التالي

التشغيل العادي (موصى به)

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: false
SetMaxLeverage: false

يقرأ البوت الرافعة المالية من symbols.json (تم تهيئتها وتحديثها بالفعل).

إضافة رموز جديدة

# tradesettings.yaml
Leverage: 10
SetLeverageStartup: true
SetMaxLeverage: true

1. إضافة رموز جديدة إلى البورصة
2. تفعيل SetLeverageStartup
3. تشغيل البوت → تطبيق الرافعة المالية على جميع الرموز
4. إيقاف البوت
5. تعطيل قبل التداول العادي

استكشاف الأخطاء وإصلاحها

• المشكلة: البوت يستمر في إعادة تعيين الرافعة المالية
  السبب: SetLeverageStartup: true تُرك مفعلاً
  الحل: قم بتعيينه إلى false بعد الإعداد الأولي
• المشكلة: لم يتم تطبيق الرافعة المالية
  السبب: SetLeverageStartup: false أثناء التحديث
  الحل: قم بتفعيله مؤقتًا وأعد التشغيل
• المشكلة: أخطاء API حول حدود الرافعة المالية
  السبب: الرافعة المالية المكونة تتجاوز الحد الأقصى للبورصة
  الحل: تفعيل SetMaxLeverage: true
• المشكلة: عدم تطابق symbols.json
  السبب: تغيير يدوي أو عدم التزامن
  الحل: تفعيل SetLeverageStartup: true مرة واحدة لإعادة المزامنة

أفضل الممارسات

✅ افعل

• قم بتعيين SetLeverageStartup: false بعد التحديثات الناجحة
• استخدم SetMaxLeverage: true للإعداد الأولي
• تحقق من قيم الرافعة المالية في symbols.json
• احتفظ بنسخ احتياطية قبل التغييرات
• اختبر على رمز واحد قبل الكل

❌ لا تفعل

• ترك SetLeverageStartup: true في التشغيل العادي
• تغيير الرافعة المالية دون تفعيل SetLeverageStartup
• تعديل symbols.json يدويًا
• تفعيل الإعدادين بشكل متكرر (يسبب عبئًا على API)

جدول مرجعي سريع

الدعم

1. تحقق من سجلات البوت بحثًا عن الأخطاء
2. تحقق من أن أذونات API البورصة تشمل تعديل الرافعة المالية
3. تأكد من وجود جميع الرموز في البورصة
4. تحقق من symbols.json للتأكد من الرافعة المالية الصحيحة
5. راجع حدود الرافعة المالية الخاصة بالبورصة