الإعداد الأولي للتطبيق

لا يتطلب MagicTradeBot الجديد أي خلفية إدارية أو قاعدة بيانات أو تثبيت معقد. يعمل مباشرة كـتطبيق خفيف الوزن ذاتي الاستضافة مع ملفات تهيئة YAML و JSON بسيطة. هذا يجعله فعالًا للغاية من حيث الموارد ومناسبًا لكل من المستخدمين التقنيين وغير التقنيين.

بدلاً من قواعد البيانات التقليدية، يتم تخزين جميع الإعدادات والسجلات في ملفات منظمة. يمكنك تعديلها مباشرة باستخدام أي محرر نصوص أو بيئة تطوير مدمجة (IDE).

📁 نظرة عامة على ملفات التهيئة

• appsettings.yaml — تهيئة الروبوت الأساسية وإعدادات البورصة.
• tradesettings.yaml — منطق التداول، معالجة الإشارات، وإعدادات الأتمتة.
• symbols.json — إدارة مزامنة وتتبع الرموز للبورصات.
• opentrades.yaml — ملف نظام لتتبع المراكز المفتوحة (لا تعدل).
• completedorders.yaml — يسجل التداولات المكتملة وملخصات الأرباح والخسائر.

يمكنك تشغيل الروبوت في وضع التجربة للاختبار، أو تعديل استراتيجيات التداول، أو البدء بالتداول الحقيقي باستخدام مفاتيح API حقيقية. تحقق دائمًا من إعداداتك قبل بدء التداول الحي.

🧠 إعدادات الروبوت الأساسية (appsettings.yaml)

# ===========================================================
# ملف تهيئة MagicTradeBot (appsettings.yaml)
# ===========================================================

Exchange:
  Name: "binance"     # مدعوم: binance, okx, bitget, bybit, hype | hyperliquid
  APIKEY: ""          # مفتاح API للبورصات المركزية
  APISECRET: ""       # السر API أو المفتاح الخاص (لـ Hyperliquid، استخدم مفتاح المحفظة)
  Passphrase: ""      # مطلوب فقط لبعض البورصات (OKX, Bitget)

# بديل متغيرات البيئة (موصى به)
# استخدم BINANCE_API_KEY, OKX_API_KEY، إلخ، لتجنب حفظ بيانات الاعتماد في الملفات.

# -----------------------------------------------------------
# إعدادات الرخصة
# -----------------------------------------------------------
License:
  Key: "your_license_here" # أدخل مفتاح الرخصة الصالح الخاص بك
  # إنشاء، تمديد، أو ترقية على: https://magictradebot.com

# -----------------------------------------------------------
# إعدادات التطبيق العامة
# -----------------------------------------------------------
General:
  BotName: "MyBot01"
  DemoMode: true          # true = وضع المحاكاة
  DebugMode: false
  Timezone: "UTC"

# -----------------------------------------------------------
# تهيئة بيانات السوق / Kline
# -----------------------------------------------------------
Kline:
  RefreshInterval: 3
  maxKlineLength: 30
  chunkSize: 20
  refreshRate: 7
  summaryInterval: "3m"
  strategyIntervals:
    scalp: ["3m"]
    day: ["15m", "30m", "1h", "2h"]
    swing: ["1h", "2h", "4h", "6h"]
    long: ["1d"]
    default: ["5m", "15m", "1h"]

# -----------------------------------------------------------
# حدود الطلبات
# -----------------------------------------------------------
rateLimits:
  maxRequestsPerSecond: 10
  safeBuffer: 0.2

# -----------------------------------------------------------
# قنوات البث / الإشعارات
# -----------------------------------------------------------
BroadCast:
  whatsapp_token: null
  whatsapp_phone_id: null
  discord_webhook_url: null
  instagram_token: null
  telegram_bot_token: null
  telegram_chat_id: null

✅ للحصول على تفاصيل التهيئة الكاملة والضبط المتقدم (أوضاع التداول، معالجة الإشارات، إدارة الأموال)، قم بزيارة قسم التهيئة.

🤖 منطق التداول وتهيئة الإشارات (tradesettings.yaml)

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

# MAGIC TRADE BOT - إعدادات التداول
# --------------------------------

General:
  Profile: "scalp"
  BaseCurrency: "USDT"
  SyncSymbolsOnStartup: true
  InitialTradeAmount: 100.0
  Leverage: 5
  MaxOpenTrades: 10
  MoneyManagementStrategy: 0

SignalSettings:
  enable_extreme_volatility: true
  supported_volatility_action:
    - "BUY"
    - "SELL"
    - "PUMP"
    - "CRASH"
  enable_fisher_only_detection: true
  pump_multiplier: 0.04
  crash_multiplier: 0.025

SLTPSettings:
  StopLossPercent: 0.0
  TakeProfitPercent: 0.0
  EnableTrailingSl: false
  EnableBreakeven: false
  EnableTrailingTp: false

IntelligentRuleOptions:
  IsEnabled: true
  UseOriginalTPAsBase: false
  CandleExitRules:
    IsEnabled: false

IntelligentGlobalSettings:
  MinProfitToEnableTP: 0.0
  MaxLossBeforeForceClose: -30.0

💡 يمكن تخصيص كل قسم أو تعطيله بشكل مستقل. يقوم الروبوت بتعديل منطق التداول ديناميكيًا بناءً على هذه الإعدادات. لاستكشاف جميع الحقول المتاحة، تحقق من الوثائق التفصيلية تهيئة التداول.

📦 إدارة الرموز (symbols.json)

يمكن للروبوت مزامنة جميع الرموز القابلة للتداول تلقائيًا من البورصة المتصلة (على سبيل المثال، أكثر من 500 زوج على Binance). يمكنك تعطيل المزامنة أو تقييدها بأزواج تداول محددة.

{
  "syncEnabled": true,
  "includeSymbols": ["BTCUSDT", "ETHUSDT"],
  "excludeSymbols": ["USDCUSDT"]
}

يمكنك أيضًا تحديد إعدادات لكل رمز للرافعة المالية، فترات التهدئة، أو المحفزات لتحسين استراتيجية التداول الخاصة بك لأسواق محددة.

💾 ملفات النظام

• opentrades.yaml — يخزن التداولات النشطة حاليًا. لا تعدل يدويًا.
• completedorders.yaml — يسجل تاريخ التداول ونتائج الأرباح والخسائر للتقارير وتتبع الأداء.

تساعد هذه الملفات الروبوت على استئناف العمل بأمان بعد إعادة التشغيل والحفاظ على الاتساق بين الجلسات الحية والتجريبية.

🚀 ملخص البدء السريع

• قم بتحميل حزمة MagicTradeBot.
• قم بتعديل appsettings.yaml وtradesettings.yaml.
• أضف مفاتيح API الخاصة بالبورصة أو قم بتعيينها عبر متغيرات البيئة.
• قم بتشغيل الروبوت — سيقوم تلقائيًا بتحميل الرموز، بدء المسح، وإدارة التداولات.