ما هي الإعدادات التي يجب تكوينها قبل تشغيل MagicTradeBot لأول مرة؟

  • Home
  • Documentation
  • ما هي الإعدادات التي يجب تكوينها قبل تشغيل MagicTradeBot لأول مرة؟

دليل الإعداد الأولي

قبل تشغيل MagicTradeBot لأول مرة، يجب تكوين مجموعة صغيرة من الإعدادات الإلزامية والموصى بها لضمان بدء تشغيل البوت بشكل صحيح، واتصاله الآمن بمنصة التداول الخاصة بك، وعمله دون أخطاء.

تم تصميم MagicTradeBot بإعدادات افتراضية آمنة، لذلك لا تحتاج إلى تكوين كل ملف مسبقًا. تغطي الخطوات أدناه الحد الأدنى من الإعدادات المطلوبة والموصى بها لتشغيل أول سلس.

1. تكوين منصة التداول في application.yaml

يجب عليك تحديد منصة التداول التي سيتصل بها MagicTradeBot.

Exchange:
  Name: "bybit"

منصات التداول المدعومة:

  • Binance
  • Bybit
  • OKX
  • Bitget
  • Hyperliquid

⚠️ مهم: كل منصة تداول لها متطلبات صارمة لوضع المراكز (أحادي الاتجاه مقابل التحوط). تأكد من تكوين حساب منصة التداول الخاص بك وفقًا لذلك قبل تشغيل البوت.

2. تعيين بيانات اعتماد API لمنصة التداول (إلزامي)

يحتاج MagicTradeBot إلى وصول API لوضع وإدارة الصفقات.

الطريقة الموصى بها: متغيرات البيئة (أفضل الممارسات)

يوصى بشدة باستخدام متغيرات البيئة، خاصة للإنتاج، للأسباب التالية:

  • لا يتم تخزين مفاتيح API في ملفات
  • المفاتيح أكثر أمانًا وأسهل في التدوير
  • متغيرات البيئة تتجاوز قيم YAML تلقائيًا

إعداد متغيرات البيئة حسب نظام التشغيل

✅ Windows (PowerShell)
setx BINANCE_API_KEY "مفتاح_api_الخاص_بك_هنا"
setx BINANCE_API_SECRET "سر_api_الخاص_بك_هنا"

أعد تشغيل الطرفية (أو النظام) بعد تعيين المتغيرات.

✅ Linux / macOS (الطرفية)
export BINANCE_API_KEY="مفتاح_api_الخاص_بك_هنا"
export BINANCE_API_SECRET="سر_api_الخاص_بك_هنا"

لجعلها دائمة، أضف الأسطر إلى:

  • ~/.bashrc
  • ~/.zshrc
  • ملف ملف تعريف الصدفة الخاص بك
✅ Docker / Docker Compose
environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

أسماء متغيرات البيئة المدعومة

أمثلة:

  • BINANCE_API_KEY, BINANCE_API_SECRET
  • BYBIT_API_KEY, BYBIT_API_SECRET
  • OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
  • BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
  • HYPERLIQUID_PRIVATE_KEY

🔐 لا تقم أبدًا بتمكين أذونات السحب على مفاتيح API.

3. تقديم مفتاح الترخيص الخاص بك

في application.yaml:

License:
  Key: "مفتاح_الترخيص_الخاص_بك_هنا"

كيفية الحصول على مفتاح الترخيص الخاص بك

  1. سجل الدخول إلى https://magictradebot.com
  2. انتقل إلى التنزيلات
  3. انسخ مفتاح الترخيص الخاص بك

ملاحظات مهمة

  • لا يزال بإمكان البوت العمل بدون ترخيص
  • ومع ذلك، ستكون الميزات محدودة
  • يحدث التحقق من صحة الترخيص عند بدء التشغيل

4. مراجعة إعدادات التداول الأساسية (trading.yaml)

للمستخدمين الجدد، لا يتطلب هذا الملف تغييرات إلزامية.

يمكنك اختياريًا مراجعة أو تعديل:

  • مبلغ التداول الأولي
  • الرافعة المالية الافتراضية
  • حدود المخاطرة

إذا لم تكن متأكدًا، اترك الإعدادات الافتراضية — فهي آمنة للتشغيل الأولي ووضع العرض التوضيحي.

5. إعداد الرموز والرافعة المالية لأول مرة (مهم جدًا)

الخطوة 1: تمكين مزامنة الرموز (للتشغيل الأول فقط)

في trading.yaml (أو ملف تكوين الرموز):

SyncSymbolsOnStartup: true

سيؤدي هذا إلى:

  • جلب جميع الرموز المدعومة من منصة التداول
  • إنشاء أو تحديث symbols.json
  • إزالة الرموز المحذوفة من القائمة
  • إضافة الرموز المدرجة حديثًا

➡️ قم بتشغيل البوت وانتظر حتى اكتمال مزامنة الرموز
➡️ راقب ملف symbols.json
➡️ أوقف البوت بمجرد اكتمال المزامنة

الخطوة 2: تعطيل مزامنة الرموز (اختياري)

بعد المزامنة الأولى، يمكنك تعيين:

SyncSymbolsOnStartup: false

إذا كنت تريد تحديثات تلقائية للرموز، فاتركه على true بشكل دائم.

الخطوة 3: إعداد الرافعة المالية لمرة واحدة (اختياري لكن موصى به)

إذا كنت تريد أن يقوم MagicTradeBot بتكوين الرافعة المالية تلقائيًا:

SetLeverageStartup: true
SetMaxLeverage: false
  • يطبق هذا الرافعة المالية التي قمت بتكوينها (مثل 10x) على جميع الرموز المدعومة
  • قم بتشغيل البوت مرة واحدة
  • انتظر بضع دقائق لتحديثات الرافعة المالية
  • ثم أعد تعيين كلا الخيارين إلى false

⚠️ لا تترك هذه الخيارات ممكّنة بشكل دائم، وإلا ستتم إعادة تعيين الرافعة المالية عند كل إعادة تشغيل.

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

إذا كنت تريد أقصى رافعة مالية تسمح بها منصة التداول:

SetMaxLeverage: true

استخدم هذا مرة واحدة فقط، ثم عطله مرة أخرى.

6. اختر الرموز للتداول (اختياري)

يمكنك:

  • تداول جميع الرموز المتزامنة (500+)
  • أو قصر التداول على رموز محددة فقط

مثال:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

إذا كنت تتداول جميع الرموز، فاترك:

SyncSymbolsOnStartup: true

7. تكوين الإشعارات (موصى به بشدة)

قم بإعداد قناة إشعارات واحدة على الأقل في notification.yaml:

  • Telegram
  • Discord

يسمح لك هذا بتلقي:

  • تنفيذات الصفقات
  • الأخطاء والإخفاقات
  • تنبيهات مراقبة السوق
  • أحداث الطوارئ

التشغيل بدون إشعارات ممكن، لكنه غير موصى به.

قائمة التحقق النهائية (التشغيل الأول)

قبل بدء MagicTradeBot، تأكد من:

  • ✅ تم تحديد منصة التداول في application.yaml
  • ✅ تم تعيين بيانات اعتماد API (يفضل عبر متغيرات البيئة)
  • ✅ تمت إضافة مفتاح الترخيص (اختياري لكن موصى به)
  • ✅ تم تمكين مزامنة الرموز للتشغيل الأول
  • ✅ تم إكمال إعداد الرافعة المالية الاختياري مرة واحدة
  • ✅ تم تكوين قناة الإشعارات

هذا كل شيء.
لا يلزم أي تكوين آخر لبدء التداول بأمان وبشكل صحيح.

📎 Related Topics