MagicTradeBot v3.1 — تقديم ميزة نسخ تداول الحيتان في Hyperliquid

🚀 نظرة عامة

يُعد Hyperliquid Whale Tracker وحدة جديدة في MagicTradeBot v3.1 تم تصميمها للمتداولين الذين يرغبون في الاستفادة من شفافية البلوكشين. يقوم بمراقبة محافظ الحيتان المختارة بشكل مستمر ويتفاعل عندما تفتح هذه المحافظ أو تُغلق مراكزها. يمكنك استخدامه في وضعين رئيسيين:

• وضع الإشعارات فقط — استلم تنبيهات صفقات الحيتان في الوقت الفعلي عبر Telegram أو Discord أو WhatsApp أو Webhooks.
• وضع النسخ (المرآة) — نفّذ الصفقات المنسوخة تلقائيًا على حساب التداول المرتبط بك مع ضوابط أمان ذكية.

تتم إدارة الإعداد بالكامل من خلال ملف tradesettings.yaml ويمكن تفعيله لكل نسخة من البوت. بشكل افتراضي، يكون معطلاً لأسباب أمان.

⚙️ مثال على الإعداد

لتفعيل المتتبع، أضف القسم التالي إلى ملف tradesettings.yaml:

HyperLiquidWhaleTracker:
  is_enabled: true
  tracking_addresses:
    - "0x2aB3...Ff12"
    - "0x1cD4...Aa77"
  place_order: true
  order_amount: 150.0
  leverage: 3
  broadcast_signals: true
  max_open_per_whale: 2
  slippage_tolerance_percent: 0.5
  follow_partial_fills: true
  close_on_whale_close: true
  include_liquidations: false
  only_follow_buy: false
  only_follow_sell: false
  min_whale_order_value: 100.0
  cooldown_seconds: 60

يقوم هذا الإعداد بتتبع محفظتين للحيتان، وينسخ صفقاتهما برافعة مالية 3x وقيمة 150 دولارًا لكل صفقة، ويُغلق الصفقات المنسوخة تلقائيًا عند إغلاق الحيتان لصفقاتها.

🧠 آلية العمل

1. مصدر الأحداث — يشترك البوت في أحداث المحافظ على شبكة Hyperliquid للعناوين المحددة.
2. اكتشاف الحدث — عند فتح أو إغلاق الحوت لمركز، يتحقق البوت من الصفقة بناءً على الفلاتر (الحجم، فترة التهدئة، الاتجاه).
3. القرار — إذا كانت place_order = true، يتم إنشاء صفقة منسوخة عبر واجهة API الخاصة بالمنصة المتصلة؛ وإلا يتم إرسال إشارة فقط.
4. التنفيذ — يتم وضع الأوامر وفقًا لقيود الانزلاق والرافعة والهامش المتاح. يمكن نسخ التنفيذ الجزئي بنسبة متناسبة.
5. دورة الحياة — يراقب البوت المراكز المنسوخة ويغلقها تلقائيًا إذا تم تفعيل close_on_whale_close.
6. التسجيل والتنبيهات — يتم تسجيل جميع الأحداث وإرسالها اختياريًا إلى قنوات التنبيه أو المراقبة الخاصة بك.

🔒 الأمان وإدارة المخاطر

• لا تقم أبدًا بكتابة مفاتيح API أو المفاتيح الخاصة داخل الكود — استخدم متغيرات البيئة أو الأسرار المشفرة.
• حدد الأذونات لـ التداول فقط؛ لا تفعّل عمليات السحب مطلقًا.
• استخدم DemoMode للاختبار الأولي قبل التشغيل الفعلي.
• اضبط max_open_per_whale وslippage_tolerance_percent بحذر.
• فعّل مراقبة الأخطاء (مثل Sentry أو PagerDuty) عند التشغيل في بيئة الإنتاج.

📣 التنبيهات والإشعارات

عند تفعيل broadcast_signals: true، يقوم MagicTradeBot بإرسال تنبيهات منسقة لكل حدث تداول لحوت.

مثال (Telegram / Discord):

[Hyperliquid Whale] طلب جديد
الحوت: 0x2aB3...Ff12
الإجراء: شراء (طويل)
الرمز: BTCUSDT
الحجم: 0.5 BTC (~25,000 USDT)
الرافعة: 3x
تم النسخ: نعم (رقم الطلب: M-123456)

مثال (Webhook JSON):

{
  "type": "hyperliquid.whale.event",
  "whale_address": "0x2aB3...Ff12",
  "action": "open",
  "side": "buy",
  "symbol": "BTCUSDT",
  "size": 0.5,
  "notional": 25000,
  "leverage": 3,
  "mirrored": true,
  "timestamp": "2025-10-16T12:34:56Z"
}

🧩 الاختبار ووضع العرض التجريبي

• اضبط place_order: false وDemoMode: true للاختبار الآمن.
• تحقق من رسائل الإشارات قبل تفعيل النسخ التلقائي.
• ابدأ بمقدار صغير في order_amount وتأكد من دقة اكتشاف الأحداث.
• راقب ملف completedorders.yaml لسجلات الصفقات المنسوخة.

⚡ أفضل الممارسات التشغيلية

• استخدم cooldown_seconds لمنع التداول المفرط الناتج عن تقسيم أوامر الحيتان.
• احتفظ بـ وضع الإشعارات فقط أثناء الأسواق المتقلبة.
• ادمج مع وحدات إدارة الأموال لضبط ديناميكي للأحجام وتقليل المخاطر.
• استخدم Prometheus وLoki لمراقبة الأداء وتدقيق الأحداث.

⚠️ القيود والمخاطر

• تتبع الحيتان ≠ أرباح مضمونة — يمكن أن يخسر الحيتان أو يتلاعبوا بالسوق أيضًا.
• قد تؤدي فترات التأخير والانزلاق إلى اختلافات في نتائج الصفقات المنسوخة.
• تتبع عدد كبير من المحافظ يزيد من الضغط على واجهات API — اضبط حدود المعدل وفقًا لذلك.

💬 الأسئلة الشائعة

س: هل يمكنني تتبع أي محفظة؟

نعم. أضف أي عنوان محفظة عام ضمن tracking_addresses — وسيتعرف البوت تلقائيًا على نشاط التداول المرتبط بها.

س: هل يطابق حجم الصفقة حجم مركز الحوت؟

لا. يستخدم البوت القيمة المحددة في order_amount أو الحجم النسبي إذا تم تفعيل follow_partial_fills.

س: ماذا لو أرسل الحوت أوامر صغيرة متعددة؟

استخدم cooldown_seconds وfollow_partial_fills لتجنب التكرار المفرط للصفقات والسيطرة على التعرض الزائد.

⚖️ الإشعار القانوني والأخلاقي

رغم أن تتبع نشاط المحافظ العامة شفاف على السلسلة، تأكد من الالتزام بشروط المنصات والقوانين المحلية. يوفر MagicTradeBot الأدوات — وأنت مسؤول عن الاستخدام القانوني والأخلاقي لها.

🛠️ الدعم وحل المشكلات

• تحقق من ملف completedorders.yaml والسجلات لاكتشاف الأخطاء.
• تأكد من إعداد أذونات API ومتغيرات البيئة بشكل صحيح.
• تواصل مع دعم MagicTradeBot الرسمي عبر لوحة التحكم للحصول على المساعدة الفنية.