دليل التثبيت

المتطلبات الأساسية

• Docker Desktop (مطلوب فقط عند استخدام Redis)
• حساب في منصة تداول مدعومة مع مفاتيح API
• عنوان IP العام الخاص بالخادم (لإدراج IP في القائمة البيضاء للـ API)

جدول المحتويات

1. إعداد البوت
2. إعداد مفتاح API
3. إعداد Redis
4. RedisMarketBridge
5. تشغيل البوت
6. استكشاف الأخطاء وإصلاحها
7. تكامل TradingView

1. إعداد البوت

يتم إعداد جميع الإعدادات عبر المُكوّن الإلكتروني (Configurator).

1. افتح: المُكوّن (Configurator)
2. اختر MagicTradeBot
3. قم بالإعداد:

تصدير الإعدادات:

1. اضغط تصدير جميع ملفات YAML
2. قم بفك الضغط
3. استبدل مجلد /settings في المشروع

magictradebot/
├── settings/  ← استبدل
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. إعداد مفتاح API

🔐 الأمان: استخدم دائمًا متغيرات البيئة. لا تقم أبدًا بحفظ مفاتيح API داخل ملفات الإعداد.

إضافة IP للقائمة البيضاء

curl ifconfig.me

أضف هذا الـ IP إلى قائمة السماح في منصة التداول.

استخدام ملف .env

BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ أضف ملف .env إلى .gitignore

3. إعداد Redis (اختياري)

مطلوب فقط إذا تم تفعيل Redis.

تشغيل Redis عبر Docker

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

التحقق

docker exec -it magictradebot-redis redis-cli ping

النتيجة المتوقعة: PONG

4. RedisMarketBridge

هذا المكوّن يقوم بإرسال بيانات السوق الحية إلى Redis.

⚠️ يجب أن تتطابق المنصة + الأزواج + الفريمات تمامًا مع إعدادات البوت

الخطوات:

1. الإعداد عبر المُكوّن
2. تصدير ملفات YAML
3. استبدال adapters/redismarketbridge/settings

5. تشغيل البوت

ترتيب التشغيل

1. تشغيل Redis
2. تشغيل RedisMarketBridge
3. الانتظار لمدة دقيقتين
4. تشغيل MagicTradeBot

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 شغّل من الطرفية لعرض السجلات (Logs)

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

أخطاء API

• تحقق من قائمة IP المسموح بها
• تحقق من الصلاحيات
• تأكد من متغيرات البيئة

عدم وجود بيانات سوق

• انتظر دقيقتين بعد تشغيل RedisMarketBridge
• تحقق من تطابق الإعدادات

مشاكل Redis

• تأكد من تشغيل Docker
• تأكد أن المنفذ 6379 مفتوح

7. تكامل إشارات TradingView

يدعم MagicTradeBot الإشارات الخارجية من TradingView عبر Webhooks.

كيف يعمل النظام

• TradingView يرسل تنبيهات → Webhook
• البوت يستقبل الإشارات
• يقوم بتنفيذ الصفقات تلقائيًا

الخطوة 1 — تفعيل Webhook في البوت

داخل إعدادات البوت:

• تفعيل Signals → Webhook
• نسخ رابط الـ Webhook

مثال:

http://your-server:port/webhook

الخطوة 2 — إنشاء تنبيه في TradingView

1. افتح الرسم البياني في TradingView
2. أضف المؤشر أو الاستراتيجية
3. اضغط Alert
4. فعّل Webhook URL
5. ألصق رابط Webhook الخاص بالبوت

الخطوة 3 — تعريف رسالة التنبيه

مثال على JSON:

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

الإجراءات المدعومة

• buy
• sell
• close

ملاحظات مهمة

• تأكد أن الرمز (symbol) يطابق إعدادات البوت تمامًا
• استخدم نفس الإطار الزمني
• اختبر أولًا بصفقات صغيرة

⚠️ أي خطأ في تنسيق البيانات → سيتم تجاهل الإشارات

اختبار

يمكنك محاكاة Webhook باستخدام:

curl -X POST http://your-server/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ إذا كان الإعداد صحيحًا، سيقوم البوت بتنفيذ صفقة

💡 للحصول على تفاصيل كاملة، راجع التوثيق الرسمي لـ TradingView.