व्हेल वॉचर

नोट: रिपॉजिटरी एक पूर्ण-सुविधा युक्त ट्रेडिंग बॉट, ओपनक्लॉ जैसे एजेंट में परिवर्तित हो रही है जिससे आप अपने टेलीग्राम में बात कर सकते हैं और निर्णय लेने से पहले शोध करने के लिए एजेंटों की एक टीम तैनात कर सकते हैं।

Polymarket और Kalshi भविष्यवाणी बाजारों पर बड़े लेन-देन की निगरानी करने के लिए एक Rust CLI टूल। वास्तविक समय में महत्वपूर्ण बाजार गतिविधि के लिए सतर्कता, अंतर्निहित विसंगति का पता लगाने के साथ।

रिपॉजिटरी: https://github.com/neur0map/polymaster

अस्वीकरण

यह टूल केवल सूचनात्मक और शोध उद्देश्यों के लिए है। इस डेटा का उपयोग केवल सूचित निर्णय लेने और बाजार विश्लेषण के लिए करें।

विशेषताएँ

मुख्य निगरानी

• Polymarket और Kalshi लेन-देन की वास्तविक समय निगरानी
• Kalshi WebSocket — तत्काल ट्रेड का पता लगाना (HTTP पोलिंग फॉलबैक)
• Polymarket सर्वर-साइड फ़िल्टरिंग — API पहले से व्हेल ट्रेड को फ़िल्टर करती है, कोई व्यर्थ बैंडविड्थ नहीं
• अनुकूलन योग्य थ्रेशोल्ड (डिफ़ॉल्ट $25,000) और पोलिंग अंतराल
• बार-बार आने वाले अभिनेताओं के लिए ट्रिपल बीप के साथ ऑडियो अलर्ट
• बाजार श्रेणी फ़िल्टरिंग (10 श्रेणियाँ, 35+ उपश्रेणियाँ)
• प्लेटफ़ॉर्म चयन (केवल Polymarket, केवल Kalshi, या दोनों)

व्हेल इंटेलिजेंस (Polymarket)

• व्हेल प्रोफ़ाइल — पोर्टफोलियो मूल्य, लीडरबोर्ड रैंक, लाभ, जीत दर, खुले पद
• लीडरबोर्ड खोज — जाँचता है कि वॉलेट शीर्ष 500 Polymarket व्यापारियों में है या नहीं
• 12-घंटे वॉलेट मेमोरी — लौटने वाली व्हेल, पोजीशन डबलिंग, और व्हेल फ्लिप का पता लगाना
• शीर्ष धारक — प्रति बाजार शीर्ष 5 धारक और उनकी हिस्सेदारी एकाग्रता दिखाता है
• प्रोफ़ाइल 30 मिनट में कैश होती हैं, लीडरबोर्ड 1 घंटे में कैश होता है

बाजार खुफिया

• दोनों प्लेटफ़ॉर्म के लिए ऑर्डर बुक गहराई (Polymarket CLOB + Kalshi ऑर्डरबुक)
• बाजार संदर्भ — हाँ/नहीं ऑड्स, स्प्रेड, 24 घंटे का वॉल्यूम, ओपन इंटरेस्ट, मूल्य परिवर्तन, तरलता
• API से मूल Kalshi श्रेणियाँ (कीवर्ड मिलान से अधिक सटीक)
• Gamma API से निकाले गए Polymarket टैग
• चरम दांव, विपरीत स्थितियों और बड़ी पूंजी के लिए विसंगति का पता लगाना

वॉलेट ट्रैकिंग

• बार-बार आने वाले अभिनेताओं (1 घंटे में 2+ लेन-देन) के लिए उच्च अलर्ट
• भारी अभिनेताओं (24 घंटे में 5+ लेन-देन) के लिए उच्च प्राथमिकता अलर्ट
• प्रति वॉलेट वॉल्यूम और लेन-देन आवृत्ति ट्रैक करता है
• लौटने वाली व्हेल का पता लगाना (डबलिंग डाउन, फ्लिपिंग पोजीशन)
• पुनरारंभ के दौरान SQLite-समर्थित स्थायी वॉलेट मेमोरी

एकीकरण

• n8n, Zapier, Make, Discord, या किसी भी एंडपॉइंट पर वेबहुक सूचनाएँ
• बाजार संदर्भ, व्हेल प्रोफ़ाइल, ऑर्डर बुक और शीर्ष धारकों के साथ समृद्ध JSON पेलोड
• अलर्ट स्कोरिंग और प्राथमिकता फ़िल्टरिंग के लिए स्कोरिंग MCP सर्वर

बुनियादी ढाँचा

• अलर्ट इतिहास और वॉलेट मेमोरी के लिए SQLite डेटाबेस
• कॉन्फ़िगरेबल डेटा प्रतिधारण (7, 30, 90 दिन, या हमेशा के लिए)
• 6-चरणीय गाइडेड सेटअप विज़ार्ड
• बुनियादी कार्यक्षमता के लिए कोई API कुंजी आवश्यक नहीं (सार्वजनिक डेटा)
• Rust के साथ निर्मित तेज़ और कुशल

त्वरित प्रारंभ

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

बस इतना ही। कोई API कुंजी आवश्यक नहीं — सभी डेटा सार्वजनिक एंडपॉइंट से आता है। आप कुछ ही सेकंड में अपने टर्मिनल में व्हेल अलर्ट देखेंगे।

प्लेटफ़ॉर्म, श्रेणियाँ, थ्रेशोल्ड, वेबहुक और वैकल्पिक API कुंजियाँ कॉन्फ़िगर करने के लिए wwatcher setup चलाएँ।

विस्तृत सेटअप निर्देशों और वेबहुक एकीकरण के लिए QUICKSTART.md देखें।

स्थापना

स्रोत से

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

बाइनरी target/release/wwatcher पर होगी। या इसे सिस्टम-वाइड इंस्टॉल करें:

cargo install --path .

API जानकारी

wwatcher 3 Polymarket APIs, 1 Kalshi REST API, और 1 Kalshi WebSocket में 15 API एंडपॉइंट का उपयोग करता है। पूर्ण एंडपॉइंट दस्तावेज़ीकरण के लिए docs/API_REFERENCE.md देखें।

Polymarket (3 APIs, कोई प्रमाणीकरण आवश्यक नहीं)

API	बेस URL	उपयोग किए गए एंडपॉइंट
Data API	data-api.polymarket.com	trades, value, positions, closed-positions, leaderboard, top-holders
Gamma API	gamma-api.polymarket.com	markets (context + tags)
CLOB API	clob.polymarket.com	book (order book depth)

Kalshi (REST + WebSocket)

API	बेस URL	उपयोग किए गए एंडपॉइंट
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	trade channel (real-time)

सभी एंडपॉइंट सार्वजनिक हैं — कोई API कुंजी आवश्यक नहीं। उन्नत Kalshi पहुँच के लिए, wwatcher setup चलाएँ।

वेबहुक एकीकरण

wwatcher किसी भी वेबहुक URL पर समृद्ध JSON पेलोड भेजता है जिसमें शामिल हैं: बाजार संदर्भ, व्हेल प्रोफ़ाइल, ऑर्डर बुक गहराई, शीर्ष धारक और वॉलेट गतिविधि।

docs/WEBHOOK_REFERENCE.md देखें:

• सभी फ़ील्ड के साथ पूर्ण पेलोड स्कीमा
• n8n Telegram/Discord संदेश टेम्पलेट
• फ़िल्टर उदाहरण (भारी अभिनेता, शीर्ष 100 व्हेल, केवल निकास)
• गणना किए गए फ़ील्ड (व्हेल गुणवत्ता स्कोर, बिड/आस्क असंतुलन)

अलर्ट उदाहरण

जब एक व्हेल लेन-देन का पता लगाया जाता है, तो आपको समृद्ध आउटपुट दिखाई देगा:

[ALERT] LARGE TRANSACTION DETECTED - Polymarket
======================================================================
Question:   Will Bitcoin reach 100k by end of 2026?
Position:   BUYING 'Yes' shares
Prediction: Market believes 'Yes' has 65.0% chance

TRANSACTION DETAILS
Amount:     $50,000.00
Contracts:  76923.08 @ $0.6500 each
Action:     BUY shares
Timestamp:  2026-02-13T18:00:00Z

[WALLET ACTIVITY]
Wallet:   0x742d35...f0bEb
Txns (1h):  2
Txns (24h): 5
Volume (24h): $380,000.00
Status: HEAVY ACTOR (5+ transactions in 24h)

[MARKET CONTEXT]
Odds:          YES 65.0% | NO 35.0%
Spread:        $0.02 (tight)
24h Volume:    $450,000
Open Interest: $2,100,000
24h Move:      +3.2%
Liquidity:     $180,000
Tags:          crypto, bitcoin

[WHALE PROFILE]
Leaderboard:  #45 (TOP 50)
Profit:       +$890,000
Portfolio:    $2,340,000
Open Pos:     12
Win Rate:     73.0%
Markets:      195

[ORDER BOOK]
Best Bid:   $0.6400  |  Best Ask: $0.6600  |  Spread: $0.0200
Bid Depth:  $45,000 (12 levels)  |  Ask Depth: $38,000 (9 levels)
Imbalance:  54% bid / 46% ask (moderate bid pressure)

[TOP HOLDERS]
  #1: 0x742d...bEb — 150,000 shares (12.0%)
  #2: 0x8a3f...1D  — 120,000 shares (9.6%)
  #3: 0x5b9c...aF  — 95,000 shares (7.6%)
  Top 3 control 29.2% of shares
======================================================================

कमांड

wwatcher watch                        # निगरानी शुरू करें (डिफ़ॉल्ट: $25k थ्रेशोल्ड, 5s अंतराल)
wwatcher watch -t 50000               # थ्रेशोल्ड $50,000 पर सेट करें
wwatcher watch -t 10000 -i 10         # $10k थ्रेशोल्ड, 10s पोलिंग अंतराल
wwatcher setup                        # 6-चरणीय गाइडेड कॉन्फ़िगरेशन विज़ार्ड
wwatcher status                       # वर्तमान कॉन्फ़िगरेशन और DB आँकड़े देखें
wwatcher history                      # अंतिम 20 अलर्ट देखें
wwatcher history -l 50 -p polymarket  # अंतिम 50 Polymarket अलर्ट
wwatcher history --json               # अलर्ट इतिहास को JSON के रूप में आउटपुट करें
wwatcher test-sound                   # अलर्ट ध्वनि का परीक्षण करें
wwatcher test-webhook                 # परीक्षण वेबहुक पेलोड भेजें

विस्तृत सेटअप निर्देशों के लिए QUICKSTART.md देखें।

कॉन्फ़िगरेशन

कॉन्फ़िगरेशन ~/.config/wwatcher/config.json (macOS/Linux) या %APPDATA%\wwatcher\config.json (Windows) पर संग्रहीत है।

गाइडेड 6-चरणीय विज़ार्ड के लिए wwatcher setup चलाएँ जो कॉन्फ़िगर करता है:

1. प्लेटफ़ॉर्म — Polymarket, Kalshi, या दोनों
2. श्रेणियाँ — खेल, क्रिप्टो, राजनीति, अर्थशास्त्र, आदि उपश्रेणी ड्रिल-डाउन के साथ
3. थ्रेशोल्ड और प्रतिधारण — न्यूनतम ट्रेड आकार और इतिहास प्रतिधारण अवधि
4. API कुंजियाँ — वैकल्पिक Kalshi क्रेडेंशियल
5. सहेजें और सारांश

दस्तावेज़ीकरण