نسخ تداول Hyperliquid Whale — عكس صفقات المحترفين فورًا

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

نظرة عامة

يراقب متتبع الحيتان في هايبرليكويد عناوين المحافظ (الحيتان) ويتفاعل عندما تفتح هذه المحافظ أو تغلق مراكز. يدعم نمطين رئيسيين:

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

هذه الميزة قابلة للتكوين بالكامل من خلال tradesettings.yaml ويمكن تمكينها لكل نسخة من البوت. بشكل افتراضي، تكون معطلة.

التكوين

أضف أو قم بتحديث قسم HyperLiquidWhaleTracker داخل tradesettings.yaml (أو النسخة appsettings.yaml إذا كنت تستخدم إعدادات مركزية). مثال: 

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # أضف عنوان أو أكثر لمحافظ الحيتان
    - "0x1cD4...Aa77"
  place_order: false             # true = تنفيذ أوامر معكوسة تلقائيًا، false = إشارات فقط
  order_amount: 100.0            # المبلغ بالعملة الأساسية لكل صفقة معكوسة
  leverage: 3                    # الرافعة المالية المستخدمة للصفقات المعكوسة (إن أمكن)
  broadcast_signals: true        # true = إرسال إشعارات عندما يفتح/يغلق الحوت صفقات
  max_open_per_whale: 2          # الحد الأقصى للصفقات المعكوسة المفتوحة لكل حوت متتبع (أمان)
  slippage_tolerance_percent: 0.5 # الحد الأقصى المقبول للانزلاق عند تنفيذ الأوامر المعكوسة
  follow_partial_fills: true     # إذا كان true، يعكس البوت التنفيذ الجزئي بشكل متناسب
  close_on_whale_close: true     # إغلاق الأمر المعكوس عندما يغلق الحوت مركزه
  include_liquidations: false    # إذا كان true، سيتم عكس التصفيات (غير موصى به)
  only_follow_buy: false         # إذا كان true، تتبع الشراء فقط
  only_follow_sell: false        # إذا كان true، تتبع البيع فقط
  min_whale_order_value: 50.0    # الحد الأدنى لقيمة الأمر (بالعملة الأساسية) للتتبع/العكس
  cooldown_seconds: 30           # الثواني التي يجب الانتظار بين معالجة الأحداث لنفس الحوت

وصف الحقول

  • is_enabled — تمكين/تعطيل متتبع الحيتان (الافتراضي: false).
  • tracking_addresses — قائمة بعناوين المحافظ التي يتم تتبعها. لا يوجد حد أقصى؛ أضف ما تريد ولكن انتبه لاستخدام الموارد.
  • place_order — عندما يكون true، يحاول البوت تنفيذ أوامر معكوسة تلقائيًا. عندما يكون false، يبث الإشارات فقط.
  • order_amount — حجم الأمر المعكوس بالعملة الأساسية (مثل USDT) لكل صفقة. فكر في استخدام تحديد الحجم بناءً على إدارة الأموال للبيئة الإنتاجية.
  • leverage — الرافعة المالية لفتح مراكز العقود الآجلة المعكوسة (فقط إذا كانت البورصة تدعم الرافعة).
  • broadcast_signals — إرسال رسائل منسقة إلى القنوات الإذاعية المكونة.
  • max_open_per_whale — حد أمان لتجنب التعرض المفرط لحوت واحد.
  • slippage_tolerance_percent — الحد الأقصى المقبول للانزلاق عند تنفيذ الأوامر.
  • follow_partial_fills — إذا تم تنفيذ أمر الحوت جزئيًا، يعكس البوت نفس النسبة المملوءة.
  • close_on_whale_close — إغلاق الأوامر المعكوسة عندما يغلق الحوت مركزه.
  • include_liquidations — عكس التصفيات فقط إذا كنت تفهم المخاطر الشديدة.
  • only_follow_buy / only_follow_sell — فلاتر لتتبع الشراء فقط أو البيع فقط.
  • min_whale_order_value — تجاهل أوامر الحيتان الصغيرة التي تقل عن هذا الحد.
  • cooldown_seconds — يمنع تدفق الأحداث عن طريق وضع فواصل زمنية لمعالجة كل حوت.

كيفية العمل (التدفق التقني)

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

المتطلبات الأساسية والأذونات

  • نسخة عاملة من MagicTradeBot مع ترخيص صالح وتكوين tradesettings.yaml.
  • مفاتيح واجهة برمجة التطبيقات للبورصة مع أذونات التداول (إذا كان place_order مفعّل). بالنسبة للإجراءات القائمة على محفظة هايبرليكويد، قد تحتاج أيضًا إلى مفتاح خاص — لا تخزن المفاتيح الخاصة كنص عادي (استخدم متغيرات البيئة).
  • اتصال إنترنت مستقر وإعدادات حد معدل مناسبة في appsettings.yaml لتجنب حظر واجهة برمجة التطبيقات.

اعتبارات الأمان

  • لا تقم بتضمين المفاتيح الخاصة أو أسرار واجهة برمجة التطبيقات في ملفات المستودع. استخدم متغيرات البيئة أو إدارة الأسرار على مستوى نظام التشغيل.
  • قصر أذونات مفتاح واجهة برمجة التطبيقات على ما هو مطلوب فقط (التداول، ويفضل عدم السماح بالسحب).
  • اختبر بدقة في DemoMode قبل تمكين الأوامر المعكوسة الحية.
  • اضبط إعدادات افتراضية متحفظة: max_open_per_whale، slippage_tolerance_percent، وmin_whale_order_value.
  • قم بتمكين التسجيل وتنبيهات الحوادث (Sentry، PagerDuty) ليتم إعلامك بأخطاء التنفيذ أو السلوك غير المتوقع.

أمثلة على الإشعارات والبث

عندما يكون broadcast_signals هو true، يرسل البوت رسالة منسقة. أمثلة على القوالب أدناه:

تيليغرام / ديسكورد (نص)


[حوت هايبرليكويد] أمر جديد
الحوت: 0x2aB3...Ff12
الإجراء: شراء (طويل)
الرمز: BTCUSDT
الحجم: 0.5 BTC (~25000 USDT)
الرافعة المالية: 3x
الوقت: 2025-10-16T12:34:56Z
معكوس: نعم (معرف الأمر: M-123456)   # أو "معكوس: لا" إذا كان place_order=false

واتساب / 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,
  "mirrored_order_id": "M-123456",
  "timestamp": "2025-10-16T12:34:56Z"
}

الاختبار ووضع العرض التوضيحي

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

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

  • استخدم max_open_per_whale لتجنب التعرض المفرط لتسلسل صفقات حوت واحد.
  • قم بتمكين cooldown_seconds لتقليل المعالجة المكررة إذا قسم الحوت الأوامر إلى العديد من الأوامر الصغيرة.
  • فضل الإشارات فقط خلال ظروف السوق المتقلبة أو عندما لا يمكنك ضمان التنفيذ السريع/التحكم في الانزلاق.
  • إذا كنت تعكس برافعة مالية، تأكد من وجود هامش وحواجز أمان (عتبات إغلاق إجباري عالمية).
  • سجل كل حدث وارد وإجراء معكوس للتدقيق والاختبار الرجعي.

التسجيل والمراقبة

التسجيل/المراقبة الموصى بها لتمكينها في appsettings.yaml أو تكوين البوت الخاص بك:

  • سجلات الطرفية لاستكشاف الأخطاء وإصلاحها في الوقت الفعلي.
  • completedorders.yaml — الصفقات المعكوسة المكتملة المحفوظة للاختبار الرجعي والربح/الخسارة.
  • التسجيل الاختياري عن بُعد: Sentry، Loki، LogDNA، DataDog للتنبيهات وسجلات التدقيق التاريخية.
  • مقاييس Prometheus لعدد المراكز المفتوحة، عدد الأوامر المعكوسة، ومعدلات الأخطاء.

معالجة الأخطاء وإعادة المحاولة

  • في حالة فشل تنفيذ الأمر، يعيد البوت المحاولة حتى 3 مرات مع تراجع أسي (قابل للتكوين).
  • إذا تجاوز الانزلاق slippage_tolerance_percent، يتم إلغاء الأمر ويتم إصدار تحذير.
  • إذا لم يمكن تنفيذ الأمر المعكوس بسبب نقص الرصيد، يبث البوت تحذيرًا ويتخطى العكس.

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

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

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

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

ج: نعم — أضف أي عنوان محفظة عام إلى tracking_addresses. سيحاول البوت اكتشاف أحداث الفتح/الإغلاق المرتبطة بهذا العنوان.

س: هل سيعكس البوت أحجام المراكز بدقة؟

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

س: ماذا لو قسم الحوت أمرًا إلى العديد من الأوامر الصغيرة؟

ج: استخدم cooldown_seconds وfollow_partial_fills للتحكم في كيفية عكس الأوامر المقسمة وتجنب التعرض المفرط.

قائمة التحقق لبدء الاستخدام

  1. قم بتمكين المتتبع: اضبط is_enabled: true في tradesettings.yaml.
  2. أضف عناوين الحيتان إلى tracking_addresses.
  3. اضبط place_order: false في البداية للتحقق من الأحداث والإشعارات.
  4. تحقق من تسليم البث إلى تيليغرام/ديسكورد/واتساب.
  5. انتقل إلى place_order: true بمجرد أن تكون مرتاحًا، وابقِ DemoMode: true حتى اكتمال التحقق الحي.
  6. راقب السجلات واضبط التنبيهات لأخطاء التنفيذ، والانزلاق، وأحداث نقص الرصيد.

مثال كامل للمقطع (انسخه إلى 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

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

الدعم واستكشاف الأخطاء

إذا واجهت مشكلات:

  • تحقق من سجلات الطرفية وcompletedorders.yaml بحثًا عن الأخطاء.
  • تحقق من مفاتيح واجهة برمجة التطبيقات والأذونات (التداول مسموح، السحب معطل).
  • تأكد من أن متغيرات البيئة تتجاوز إعدادات الملف إذا تم استخدامها للأسرار.
  • اتصل بالدعم عبر لوحة تحكم MagicTradeBot الخاصة بك أو راجع وثائق التكوين الكاملة.

📎 Related Topics