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

ملاحظة: المستودع يتحول إلى بوت تداول متكامل، وكيل شبيه بـ 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، لا يتطلب مصادقة)

API	عنوان الأساس	نقاط النهاية المستخدمة
Data API	data-api.polymarket.com	trades، value، positions، closed-positions، leaderboard، top-holders
Gamma API	gamma-api.polymarket.com	markets (السياق + الوسوم)
CLOB API	clob.polymarket.com	book (عمق دفتر الطلبات)

Kalshi (REST + WebSocket)

API	عنوان الأساس	نقاط النهاية المستخدمة
REST API	api.elections.kalshi.com/trade-api/v2	markets/trades، markets/{ticker}، markets/{ticker}/orderbook
WebSocket	wss://api.elections.kalshi.com/trade-api/ws/v2	قناة الصفقات (فوري)

جميع نقاط النهاية عامة — لا حاجة لمفاتيح 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. الحفظ والملخص

التوثيق