مراقب الحيتان

ملاحظة: المستودع يتحول إلى بوت تداول متكامل، وكيل شبيه بـ openclaw يمكنك التحدث معه عبر تيليجرام مع القدرة على نشر فريق من الوكلاء لإجراء البحوث قبل اتخاذ القرار.

أداة سطر أوامر بلغة Rust لمراقبة المعاملات الكبيرة في أسواق التنبؤ Polymarket و Kalshi. تنبيهات فورية للنشاط السوقي الهام مع كشف الحالات الشاذة المدمج.

المستودع: https://github.com/neur0map/polymaster

إخلاء مسؤولية

هذه الأداة للأغراض المعلوماتية والبحثية فقط. استخدم هذه البيانات فقط لاتخاذ القرارات المستنيرة وتحليل السوق.

الميزات

المراقبة الأساسية

• مراقبة فورية لمعاملات Polymarket و Kalshi
• Kalshi WebSocket للكشف الفوري عن الصفقات (مع خيار احتياطي باستخدام HTTP polling)
• تصفية من جانب الخادم في Polymarket — تقوم API بالتصفية المسبقة لصفقات الحيتان، لا هدر في النطاق الترددي
• حد أدنى قابل للتخصيص (افتراضيًا 25,000 دولار) وفاصل زمني للاستقصاء
• تنبيهات صوتية مع ثلاث نغمات للممثلين المتكررين
• تصفية حسب فئة السوق (10 فئات، أكثر من 35 فئة فرعية)
• اختيار المنصة (Polymarket فقط، Kalshi فقط، أو كليهما)

معلومات الحيتان (Polymarket)

• ملفات الحيتان — قيمة المحفظة، الترتيب في لوحة المتصدرين، الربح، نسبة الفوز، المراكز المفتوحة
• البحث في لوحة المتصدرين — يتحقق ما إذا كانت المحفظة ضمن أعلى 500 متداول في Polymarket
• ذاكرة المحفظة لمدة 12 ساعة — يكشف الحيتان العائدين، مضاعفة المراكز، وانعكاسات الحيتان
• أكبر الحائزين — يعرض أكبر 5 حائزين وتركيز حصتهم لكل سوق
• يتم تخزين الملفات الشخصية مؤقتًا لمدة 30 دقيقة، ولوحة المتصدرين لمدة ساعة

معلومات السوق

• عمق دفتر الطلبات لكلتا المنصتين (Polymarket CLOB + Kalshi orderbook)
• سياق السوق — احتمالات نعم/لا، فرق السعر، حجم التداول على 24 ساعة، الفائدة المفتوحة، تغير السعر، السيولة
• فئات Kalshi الأصلية من API (أكثر دقة من مطابقة الكلمات المفتاحية)
• وسوم Polymarket المستخرجة من Gamma API
• كشف الحالات الشاذة للرهانات المتطرفة، المواقف المعاكسة، ورأس المال الكبير

تتبع المحافظ

• تنبيهات مرتفعة للممثلين المتكررين (معاملتان أو أكثر في ساعة واحدة)
• تنبيهات ذات أولوية عالية للممثلين الثقيلين (5 معاملات أو أكثر في 24 ساعة)
• يتتبع حجم وتكرار المعاملات لكل محفظة
• كشف الحوت العائد (مضاعفة الرهان، قلب المراكز)
• ذاكرة محفظة مدعومة بـ SQLite مستمرة عبر عمليات إعادة التشغيل

التكاملات

• إشعارات Webhook إلى n8n، Zapier، Make، Discord، أو أي نقطة نهاية
• حمولة JSON غنية بسياق السوق، ملف الحوت، دفتر الطلبات، وأكبر الحائزين
• خادم Scoring MCP لتسجيل التنبيهات وتصفية التفضيلات

البنية التحتية

• قاعدة بيانات SQLite لسجل التنبيهات وذاكرة المحافظ
• الاحتفاظ بالبيانات قابل للتكوين (7، 30، 90 يومًا، أو للأبد)
• معالج إعداد موجه من 6 خطوات
• لا حاجة لمفاتيح API للوظائف الأساسية (جميع البيانات عامة)
• سريع وفعال، مبني بلغة Rust

بداية سريعة

git clone https://github.com/neur0map/polymaster.git
cd polymaster
cargo install --path .
wwatcher watch

هذا كل شيء. لا حاجة لمفاتيح API — جميع البيانات من نقاط نهاية عامة. سترى تنبيهات الحيتان في الطرفية الخاصة بك خلال ثوانٍ.

قم بتشغيل wwatcher setup لتكوين المنصات والفئات والحدود والإشعارات عبر webhook ومفاتيح API الاختيارية.

انظر QUICKSTART.md للحصول على تعليمات الإعداد المفصلة وتكامل webhook.

التثبيت

من المصدر

git clone https://github.com/neur0map/polymaster.git
cd polymaster
cargo build --release

سيكون الملف التنفيذي في target/release/wwatcher. أو قم بتثبيته على مستوى النظام:

cargo install --path .

معلومات API

يستخدم wwatcher 15 نقطة نهاية API عبر 3 APIs لـ Polymarket، وواجهة REST API واحدة لـ Kalshi، و WebSocket واحد لـ Kalshi. انظر docs/API_REFERENCE.md للحصول على توثيق كامل لنقاط النهاية.

Polymarket (3 APIs، لا يتطلب مصادقة)

Kalshi (REST + WebSocket)

جميع نقاط النهاية عامة — لا حاجة لمفاتيح API. للحصول على وصول محسّن لـ Kalshi، قم بتشغيل wwatcher setup.

تكامل Webhook

يرسل wwatcher حمولات JSON غنية إلى أي عنوان URL لـ webhook مع: سياق السوق، ملف الحوت، عمق دفتر الطلبات، أكبر الحائزين، ونشاط المحفظة.

انظر docs/WEBHOOK_REFERENCE.md من أجل:

• مخطط الحمولة الكامل مع جميع الحقول
• قوالب رسائل Telegram / Discord لـ n8n
• أمثلة التصفية (الممثلون الثقيلون، أعلى 100 حوت، المخارج فقط)
• الحقول المحسوبة (درجة جودة الحوت، عدم التوازن بين العرض والطلب)

مثال على التنبيه

عند اكتشاف معاملة حوت، سترى مخرجات غنية:

[تنبيه] تم اكتشاف معاملة كبيرة - Polymarket
======================================================================
السؤال:   هل سيصل البيتكوين إلى 100 ألف بحلول نهاية 2026؟
الموقف:   شراء أسهم 'نعم'
التوقع:   السوق يعتقد أن فرصة 'نعم' هي 65.0%

تفاصيل المعاملة
المبلغ:   50,000.00 دولار
العقود:   76923.08 بسعر 0.6500 دولار لكل منها
الإجراء:  شراء أسهم
الطابع الزمني: 2026-02-13T18:00:00Z

[نشاط المحفظة]
المحفظة:   0x742d35...f0bEb
المعاملات (1 ساعة):  2
المعاملات (24 ساعة): 5
الحجم (24 ساعة): 380,000.00 دولار
الحالة: ممثل ثقيل (5+ معاملات في 24 ساعة)

[سياق السوق]
الاحتمالات:          نعم 65.0% | لا 35.0%
فرق السعر:        0.02 دولار (ضيق)
حجم 24 ساعة:    450,000 دولار
الفائدة المفتوحة: 2,100,000 دولار
الحركة خلال 24 ساعة: +3.2%
السيولة:         180,000 دولار
الوسوم:          عملات رقمية، بيتكوين

[ملف الحوت]
لوحة المتصدرين:  #45 (أفضل 50)
الربح:          +890,000 دولار
المحفظة:        2,340,000 دولار
المراكز المفتوحة: 12
نسبة الفوز:     73.0%
الأسواق:        195

[دفتر الطلبات]
أفضل عرض:   0.6400 دولار  |  أفضل طلب: 0.6600 دولار  |  فرق السعر: 0.0200 دولار
عمق العروض:  45,000 دولار (12 مستوى)  |  عمق الطلبات: 38,000 دولار (9 مستويات)
عدم التوازن: 54% عرض / 46% طلب (ضغط عرض معتدل)

[أكبر الحائزين]
  #1: 0x742d...bEb — 150,000 سهم (12.0%)
  #2: 0x8a3f...1D  — 120,000 سهم (9.6%)
  #3: 0x5b9c...aF  — 95,000 سهم (7.6%)
  أكبر 3 حائزين يسيطرون على 29.2% من الأسهم
======================================================================

الأوامر

wwatcher watch                        # بدء المراقبة (الافتراضي: حد 25 ألف دولار، فاصل 5 ثوانٍ)
wwatcher watch -t 50000               # تعيين الحد إلى 50,000 دولار
wwatcher watch -t 10000 -i 10         # حد 10 آلاف دولار، فاصل استقصاء 10 ثوانٍ
wwatcher setup                        # معالج إعداد موجه من 6 خطوات
wwatcher status                       # عرض التكوين الحالي وإحصائيات قاعدة البيانات
wwatcher history                      # عرض آخر 20 تنبيهاً
wwatcher history -l 50 -p polymarket  # آخر 50 تنبيهاً من Polymarket
wwatcher history --json               # إخراج سجل التنبيهات بتنسيق JSON
wwatcher test-sound                   # اختبار أصوات التنبيه
wwatcher test-webhook                 # إرسال حمولات webhook اختبارية

انظر QUICKSTART.md للحصول على تعليمات الإعداد المفصلة.

التكوين

يُخزَّن التكوين في ~/.config/wwatcher/config.json (ماك / لينكس) أو %APPDATA%\wwatcher\config.json (ويندوز).

قم بتشغيل wwatcher setup لمعالج موجه من 6 خطوات يقوم بتكوين:

1. المنصات — Polymarket، Kalshi، أو كليهما
2. الفئات — رياضة، عملات رقمية، سياسة، اقتصاد، إلخ مع تفصيل الفئات الفرعية
3. الحد والاحتفاظ — الحد الأدنى لحجم الصفقة وفترة الاحتفاظ بالسجل
4. مفاتيح API — بيانات اعتماد Kalshi اختيارية
5. الحفظ والملخص

التوثيق

• docs/WEBHOOK_REFERENCE.md — مخطط حمولة webhook الكامل، قوالب n8n، أمثلة التصفية
• docs/API_REFERENCE.md — جميع نقاط نهاية API الخمسة عشر مع أمثلة الطلب والاستجابة
• docs/plans/ — وثائق التصميم لكل مرحلة تنفيذ

التطوير

بُني باستخدام:

• Rust — لغة برمجة أنظمة
• Tokio — وقت تشغيل غير متزامن
• Reqwest — عميل HTTP
• tokio-tungstenite — عميل WebSocket (صفقات Kalshi الفورية)
• rusqlite — قاعدة بيانات SQLite (سجل التنبيهات + ذاكرة المحفظة)
• Clap — تحليل وسيطات سطر الأوامر
• Serde — تسلسل JSON
• Colored — إخراج طرفية ملون

هيكل المشروع

src/
├── main.rs              # نقطة دخول CLI (clap)
├── config.rs            # تحميل/حفظ التكوين
├── db.rs                # قاعدة بيانات SQLite (المخطط، الاستعلامات، الترحيل)
├── categories.rs        # نظام فئات السوق (10 فئات، أكثر من 35 فئة فرعية)
├── whale_profile.rs     # معلومات الحيتان (المحفظة، لوحة المتصدرين، نسبة الفوز)
├── types.rs             # الأنواع المشتركة، متتبع المحفظة
├── alerts/
│   ├── mod.rs           # هيكل AlertData، باني الحمولة
│   ├── display.rs       # الإخراج الطرفي (جميع وظائف العرض)
│   ├── anomaly.rs       # كشف الحالات الشاذة
│   ├── history.rs       # سجل التنبيهات في SQLite
│   ├── sound.rs         # التنبيهات الصوتية
│   └── webhook.rs       # مرسل webhook
├── commands/
│   ├── mod.rs
│   ├── watch.rs         # حلقة المراقبة الرئيسية
│   ├── setup.rs         # معالج الإعداد من 6 خطوات
│   ├── status.rs        # عرض الحالة
│   └── test.rs          # اختبارات الصوت + webhook
├── platforms/
│   ├── mod.rs
│   ├── polymarket.rs    # Polymarket API (الصفقات، سياق السوق، دفتر الطلبات، أكبر الحائزين)
│   └── kalshi.rs        # Kalshi API (الصفقات، سياق السوق، دفتر الطلبات، الفئات)
└── ws/
    ├── mod.rs
    └── kalshi.rs         # عميل Kalshi WebSocket (دفق الصفقات الفوري)

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

تحذير عدم وجود تكوين

هذا طبيعي. الأداة تعمل بدون تكوين باستخدام APIs العامة. قم بتشغيل wwatcher setup فقط إذا كنت تريد إضافة مصادقة Kalshi.

أخطاء API

• Polymarket: نقطة النهاية العامة يجب أن تعمل دون مشاكل
• Kalshi: نقطة النهاية العامة تعمل بدون مصادقة، ولكن قد يتم تطبيق حدود للمعدل

الحد من المعدل

إذا كنت تواجه حدًا للمعدل:

• قم بزيادة --interval للاستقصاء بشكل أقل تكرارًا
• بالنسبة لـ Kalshi: أضف بيانات اعتماد API عبر wwatcher setup

المساهمون

شكرًا لهؤلاء المساهمين على أفكارهم وتحسيناتهم:

• @fuzmik - اقترح ميزة تسجيل سجل التنبيهات

التكامل (MCP)

يتضمن wwatcher خادم MCP للتسجيل بأداتين: score_alert و check_preferences. لا حاجة لمفاتيح API.

انظر integration/README.md للحصول على تفاصيل الإعداد والأدوات.

بوت Prowl (مخطط له)

بوت محادثة على تيليجرام مع فريق متعدد الوكلاء لأسواق التنبؤ. يتحدث البوت معك، ويحلل تنبيهات الحيتان، ويمكنه وضع صفقات في Kalshi و Polymarket بعد موافقتك.

انظر docs/plans/2026-02-25-prowl-bot-design.md للحصول على وثيقة التصميم الكاملة.

البنية

أنت (CEO) ←→ تيليجرام ←→ بوت المدير
                              │
                    ┌─────────┼─────────┐
                    ▼         ▼         ▼
                باحث      محلل     مخاطر
                    └─────────┼─────────┘
                              ▼
                      القرار + الموافقة
                              ▼
                      المنفذ (Kalshi + Polymarket)

• المدير — ذكاء اصطناعي محادثة بشخصية (soul.md)، ذاكرة مستمرة، ومهارات. يفوض للفريق.
• الباحث — يجمع بيانات السوق، الأخبار، المشاعر (ONNX)
• المحلل — يقرأ تاريخ حيتان wwatcher، يسجل التنبيهات، يكشف الأنماط
• المخاطر — يقيم حجم المركز، إدارة رأس المال
• المنفذ — يضع الصفقات بعد موافقتك

لكل وكيل روحه الخاصة (شخصية)، ومهاراته (تعليمات)، وذاكرته (قسم SQLite). سحابة LLMs للاستدلال (OpenRouter)، نماذج محلية للمهام الرخيصة (Ollama)، ONNX للتعلم الآلي (المشاعر، إعادة الترتيب، السلاسل الزمنية).

خريطة الطريق

التعلم المستمر

يجمع البوت التوقعات من اليوم الأول. عندما تُحَل الأسواق، يُنشئ بيانات تدريب تلقائيًا. ضبط دقيق لنموذج محلي 7B (MLX على ماك، مجاني) يصبح أفضل في أسواقك المحددة بمرور الوقت. بناءً على Turtel et al. 2025 — نفس النهج الذي طابق دقة o1 في Polymarket باستخدام نموذج 14B.

الترخيص

هذه الأداة للأغراض التعليمية والمراقبة. راجع شروط الخدمة لواجهات برمجة تطبيقات Polymarket و Kalshi.