دليل مستخدم Hyperliquid Whale Tracker

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

📖 نظرة عامة

متتبع الحيتان Hyperliquid هو ميزة متقدمة تراقب أنشطة محافظ الحيتان في بورصة Hyperliquid وتمكن من التداول التلقائي بالنسخ. عندما يفتح حوت متابع مركزًا جديدًا، يمكن للنظام أن يبث الإشارات تلقائيًا إلى Discord/Telegram و/أو يضع صفقات مماثلة في حسابك.

🔍 الكشف في الوقت الحقيقي

يراقب مراكز الحيتان كل 5 دقائق ويكتشف المراكز الجديدة على الفور.

📢 تنبيهات متعددة المنصات

يبث الإشارات إلى Discord وTelegram وWhatsApp بتنسيق غني.

🤖 التداول التلقائي بالنسخ

يعكس مراكز الحيتان تلقائيًا باستخدام إعداداتك المخصصة ومعايير المخاطرة.

🎯 تتبع الإغلاق الذكي

يغلق مركزك تلقائيًا عندما يغلق الحوت مركزه.

⚙️ الإعدادات

الإعدادات الأساسية

توجد في ملف الإعدادات تحت HyperLiquidWhaleTracker:

HyperLiquidWhaleTracker: is_enabled: true # تفعيل/تعطيل تتبع الحيتان tracking_addresses: # قائمة عناوين محافظ الحيتان - "0x2ea18c23f72a4b6172c55b411823cdc5335923f4" - "0xb317d2bc2d3d2df5fa441b5bae0ab9d8b07283ae" - "0x9458f423df6569f053358ee9906613cd69c1ec04" # إضافة المزيد من العناوين... place_order: false # وضع الطلبات المماثلة تلقائيًا broadcast_signals: true # البث إلى منصات المراسلة max_orders_per_whale: 2 # الحد الأقصى للطلبات المتزامنة لكل حوت

إعدادات منصة المراسلة

broadcast: # Discord discord_webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK" # Telegram telegram_bot_token: "YOUR_BOT_TOKEN" telegram_chat_id: "YOUR_CHAT_ID" # WhatsApp (اختياري) whatsapp_token: "YOUR_TOKEN" whatsapp_phone_id: "YOUR_PHONE_ID"

إعدادات التداول

general: initial_trade_amount: 100 # المبلغ بالدولار لكل صفقة leverage: 10 # مضاعف الرافعة المالية demo_mode: false # اختبار بدون صفقات حقيقية sltp_settings: take_profit_percent: 5.0 # نسبة جني الأرباح stop_loss_percent: 2.0 # نسبة وقف الخسارة

🔧 كيفية العمل

عملية الكشف

1المسح الأولي

عند التشغيل الأول، يسجل النظام جميع مراكز الحيتان الحالية دون بث (يمنع الرسائل غير المرغوب فيها).

2المراقبة المستمرة

كل 5 دقائق، يقوم النظام بما يلي:

  • يجلب المراكز الحالية لكل حوت متابع
  • يقارنها بالمراكز التي تم رؤيتها سابقًا
  • يكتشف المراكز الجديدة التي لم تكن موجودة من قبل

3تحديد المركز

يُعتبر المركز جديدًا عندما:

  • لم يكن العملة موجودة في محفظة الحوت خلال الفحص الأخير
  • لم يقم النظام ببث هذا المركز من قبل

4تنفيذ الإجراء

لكل مركز جديد:

  • يبث الإشارة إلى المنصات المُعدة (إذا كانت مفعلة)
  • يضع أمر تداول بالنسخ (إذا كان مفعلًا)
  • يضيف المركز إلى المراقبة لتتبع الإغلاق التلقائي

بيانات مركز الحوت المتتبعة

نقطة البيانات الوصف
العملة زوج التداول (مثل BTC، ETH، SOL)
الجانب مركز طويل أو قصير
الحجم حجم المركز بالعقود
سعر الدخول سعر دخول الحوت
الرافعة المالية رافعة المركز
الأرباح/الخسائر غير المحققة الربح/الخسارة الحالية
سعر التصفية عتبة المخاطر

📢 بث الإشارات

تفعيل البث

اضبط broadcast_signals: true في الإعدادات لتلقي الإشعارات عندما يفتح الحيتان مراكز.

إشعارات Discord

تنسيق التضمين الغني

  • مشفر بالألوان (أخضر للطويل، أحمر للقصير)
  • حقول منظمة تحتوي على جميع تفاصيل المركز
  • رابط قابل للنقر إلى محفظة الحوت
  • طابع زمني للتتبع
🐋 تنبيه الحوت: الحوت #1 فتح الحوت #1 مركزًا طويلًا على BTC 📊 تفاصيل المركز العملة: BTC الجانب: طويل 📈 الحجم: 50.5 الرافعة المالية: 20x 💰 معلومات السعر سعر الدخول: $65,432.10 الأرباح/الخسائر غير المحققة: $-125.50 ⏰ التوقيت تم فتح المركز: 2025-01-15 14:30:00 UTC تم الكشف: 14:35:00

إشعارات Telegram

تنسيق Markdown

  • تنسيق نصي نظيف وقابل للقراءة
  • كتل كود أحادية المسافة للبيانات
  • رابط تتبع مباشر
  • تصميم مناسب للجوال
🐋 *تنبيه الحوت* 🟢 *الحوت #1* فتح مركز *طويل* *تفاصيل المركز:* العملة : BTC الجانب : طويل الحجم : 50.5 سعر الدخول : $65,432.10 الرافعة : 20x الأرباح/الخسائر غير المحققة : $-125.50 التصفية : $60,123.45 text*التوقيت:* تم الفتح : 2025-01-15 14:30:00 UTC تم الكشف : 2025-01-15 14:35:00 text🔗 [التتبع على CoinGlass] _الحوت: 0x2ea18c23..._

اختيار المنصة

يبث النظام إلى جميع المنصات المُعدة ببيانات اعتماد صالحة. يتم تخطي المنصات بدون بيانات اعتماد تلقائيًا:

  • Discord: يتطلب discord_webhook_url
  • Telegram: يتطلب كلا من telegram_bot_token وtelegram_chat_id
  • WhatsApp: يتطلب whatsapp_token وwhatsapp_phone_id

🤖 التداول التلقائي بالنسخ

تفعيل التداول التلقائي

اضبط place_order: true ليعكس مراكز الحيتان تلقائيًا.

كيف يعمل التداول بالنسخ

  1. كشف المركز: يكتشف النظام مركز حوت جديد
  2. مطابقة الرمز: يجد زوج التداول المقابل في بورصتك
  3. التحقق من الأمر: يتحقق من حدود أوامر الحوت وتوفر البوت
  4. وضع الأمر: يضع أمر السوق بإعداداتك المُعدة
  5. المراقبة: يضيف المركز إلى نظام مراقبة الإغلاق

⚠️ مهم: إعداداتك، وليس إعدادات الحوت

تستخدم صفقات النسخ إعداداتك، وليس إعدادات الحوت:

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

مثال: يفتح الحوت 100 BTC طويل برافعة 20x → صفقة النسخ الخاصة بك: $100 BTC طويل برافعة 10x (إعداداتك)

التوافق مع البورصات

يعدل النظام الرموز تلقائيًا لبورصتك:

البورصة رمز الحوت رمزك
Binance BTC BTCUSDT
OKX BTC BTC-USDT-SWAP
Bybit BTC BTCUSDT
Bitget BTC BTCUSDT
HyperLiquid BTC BTC (بدون تغيير)

منطق وضع الأوامر

إذا تم اكتشاف مركز حوت جديد: → تحقق مما إذا كان broadcast_signals مفعلًا → إرسال الإشعارات → تحقق مما إذا كان place_order مفعلًا: → تحقق من عدم تجاوز حد أوامر الحوت → ابحث عن زوج تداول نشط مطابق → تحقق من عدم وجود أوامر جارية لدى البوت (لتجنب التعارض) → احسب حجم الأمر من إعداداتك → ضع أمر السوق مع TP/SL الخاص بك → احفظ في opentrades.yaml → أضف إلى المراقبة للإغلاق التلقائي

👁️ مراقبة المراكز والإغلاق التلقائي

تتبع الإغلاق التلقائي

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

كيف يعمل

  1. تسجيل المركز: بعد وضع صفقة النسخ، يتم إضافة المركز إلى المراقبة
  2. التحقق المستمر: كل 5 دقائق، يتحقق النظام من مراكز الحوت الحالية
  3. كشف الإغلاق: يحدد متى ينخفض حجم مركز الحوت أو يختفي
  4. تنفيذ الإغلاق التلقائي: يغلق المركز المقابل الخاص بك على الفور

سيناريوهات الإغلاق

إغلاق كامل (100%)

الحوت: يغلق المركز بالكامل

صفقةك: يغلق 100% من المركز تلقائيًا

النتيجة: يتم نقل الصفقة إلى المكتملة، ويتم مسح running_orders

إغلاق جزئي

الحوت: يقلل حجم المركز (مثل إغلاق 50%)

صفقةك: يغلق النسبة المطابقة

النتيجة: يتم تحديث الصفقة بكميات جديدة

إدارة الحالة

# قبل الإغلاق running_orders: - order_id: "12345" symbol: "BTCUSDT" status: "Active" whale_address: "0x2ea..." # بعد الإغلاق running_orders: null # تم مسحه، جاهز للصفقة التالية completed_trades: - order_id: "12345" status: "Closed" realized_pnl: 45.30 close_reason: "الحوت #1 أغلق مركز BTC"

🛡️ ميزات الأمان

حدود الأوامر

حد لكل حوت (max_orders_per_whale)

  • الافتراضي: طلبان متزامنان لكل حوت
  • قابل للتعديل: يمكن ضبط أي رقم (1-10 موصى به)
  • الغرض: يمنع التعرض المفرط لحوت واحد

مثال: الحوت #1 لديه مركزان نشطان → تم اكتشاف مركز جديد → يتحقق النظام: تم الوصول إلى الحد 2/2 → يتم تخطي الأمر: "تم الوصول إلى حد أوامر الحوت"

وضع التجربة

اختبار النظام دون المخاطرة برأس المال الحقيقي:

general: demo_mode: true # محاكاة الأوامر دون تنفيذ

في وضع التجربة:

  • ✅ يكتشف مراكز الحيتان
  • ✅ يبث الإشارات
  • ✅ يسجل تفاصيل الأوامر
  • ❌ لا يتم وضع أوامر حقيقية
  • ❌ لا يتم استدعاء واجهة برمجة تطبيقات البورصة

منع تعارض البوت

قبل وضع صفقة النسخ:

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

التحقق من المركز

يتم التحقق من كل أمر من حيث:

  • الرمز الصحيح: يجب أن يكون موجودًا في بورصتك
  • السعر الحالي: يجب أن يكون قابلًا للاسترداد (> 0)
  • حساب الكمية: يجب أن يفي بالحدود الدنيا للبورصة
  • حدود الرافعة المالية: ضمن النطاق المسموح به من البورصة

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

المشكلات الشائعة

❌ "لم يتم تهيئة عناوين الحيتان"

المشكلة: قائمة tracking_addresses فارغة

الحل:

HyperLiquidWhaleTracker: tracking_addresses: - "0xYOUR_WHALE_ADDRESS_HERE"

📎 Related Topics