Whale Watcher

Hinweis: Das Repository wird zu einem voll funktionsfähigen Trading-Bot umgebaut, einem Openclaw-ähnlichen Agenten, mit dem du in deinem Telegram sprichst und der ein Team von Agenten einsetzen kann, um vor einer Entscheidung Nachforschungen anzustellen.

Ein Rust-CLI-Tool, das große Transaktionen auf den Polymarket- und Kalshi-Prognosemärkten überwacht. Echtzeit-Benachrichtigungen über bedeutende Marktaktivitäten mit integrierter Anomalieerkennung.

Repository: https://github.com/neur0map/polymaster

HAFTUNGSAUSSCHLUSS

Dieses Tool dient nur zu Informations- und Forschungszwecken. Verwenden Sie diese Daten ausschließlich für fundierte Entscheidungen und Marktanalysen.

Funktionen

Kernüberwachung

• Echtzeit-Überwachung von Polymarket- und Kalshi-Transaktionen
• Kalshi WebSocket für sofortige Handelserkennung (HTTP-Polling als Fallback)
• Polymarket serverseitige Filterung – Die API filtert Whale-Trades vor, keine verschwendete Bandbreite
• Anpassbare Schwelle (Standard 25.000 $) und Abfrageintervall
• Audio-Benachrichtigungen mit Dreifach-Piepton bei wiederholten Akteuren
• Filterung nach Marktkategorien (10 Kategorien, 35+ Unterkategorien)
• Plattformauswahl (nur Polymarket, nur Kalshi oder beide)

Whale-Intelligenz (Polymarket)

• Whale-Profile – Portfoliowert, Leaderboard-Rang, Gewinn, Gewinnrate, offene Positionen
• Leaderboard-Abfrage – Prüft, ob sich die Wallet unter den Top-500-Polymarket-Händlern befindet
• 12-Stunden-Wallet-Speicher – Erkennt wiederkehrende Whales, Positionsverdopplungen und Whale-Wendungen
• Top-Halter – Zeigt die Top-5-Halter und deren Anteilskonzentration pro Markt an
• Profile werden 30 Minuten zwischengespeichert, Leaderboard 1 Stunde

Marktintelligenz

• Orderbuch-Tiefe für beide Plattformen (Polymarket CLOB + Kalshi Orderbuch)
• Marktkontext – JA/NEIN-Quoten, Spread, 24h-Volumen, offenes Interesse, Preisänderung, Liquidität
• Native Kalshi-Kategorien von der API (genauer als Schlüsselwortabgleich)
• Polymarket-Tags aus der Gamma-API extrahiert
• Anomalieerkennung für extreme Wetten, konträre Positionen und großes Kapital

Wallet-Tracking

• Erhöhte Benachrichtigungen für wiederholte Akteure (2+ Transaktionen in 1 Stunde)
• Hohe Priorität für schwere Akteure (5+ Transaktionen in 24 Stunden)
• Verfolgt Volumen und Transaktionshäufigkeit pro Wallet
• Erkennung wiederkehrender Whales (Verdopplung, Positionswechsel)
• SQLite-gestützter persistenter Wallet-Speicher über Neustarts hinweg

Integrationen

• Webhook-Benachrichtigungen an n8n, Zapier, Make, Discord oder jeden Endpunkt
• Umfangreiches JSON-Payload mit Marktkontext, Whale-Profil, Orderbuch und Top-Haltern
• Scoring-MCP-Server für die Bewertung von Benachrichtigungen und die Filterung nach Präferenzen

Infrastruktur

• SQLite-Datenbank für Benachrichtigungsverlauf und Wallet-Speicher
• Konfigurierbare Datenaufbewahrung (7, 30, 90 Tage oder für immer)
• 6-stufiger geführter Einrichtungsassistent
• Keine API-Schlüssel für die Basisfunktionalität erforderlich (nur öffentliche Daten)
• Schnell und effizient, entwickelt mit Rust

Schnellstart

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

Das war's. Keine API-Schlüssel erforderlich – alle Daten stammen von öffentlichen Endpunkten. Sie sehen innerhalb von Sekunden Whale-Benachrichtigungen in Ihrem Terminal.

Führen Sie wwatcher setup aus, um Plattformen, Kategorien, Schwellenwerte, Webhooks und optionale API-Schlüssel zu konfigurieren.

Siehe QUICKSTART.md für detaillierte Einrichtungsanweisungen und Webhook-Integration.

Installation

Aus dem Quellcode

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

Die Binärdatei befindet sich unter target/release/wwatcher. Oder systemweit installieren:

cargo install --path .

API-Informationen

wwatcher verwendet 15 API-Endpunkte über 3 Polymarket-APIs, 1 Kalshi-REST-API und 1 Kalshi-WebSocket. Siehe docs/API_REFERENCE.md für die vollständige Endpunktdokumentation.

Polymarket (3 APIs, keine Authentifizierung erforderlich)

API	Basis-URL	Verwendete Endpunkte
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	Basis-URL	Verwendete Endpunkte
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)

Alle Endpunkte sind öffentlich – keine API-Schlüssel erforderlich. Für erweiterten Kalshi-Zugriff führen Sie wwatcher setup aus.

Webhook-Integration

wwatcher sendet umfangreiche JSON-Payloads an jede Webhook-URL mit: Marktkontext, Whale-Profil, Orderbuch-Tiefe, Top-Haltern und Wallet-Aktivität.

Siehe docs/WEBHOOK_REFERENCE.md für:

• Vollständiges Payload-Schema mit allen Feldern
• n8n Telegram/Discord-Nachrichtenvorlagen
• Filterbeispiele (schwere Akteure, Top-100-Whales, nur Ausstiege)
• Berechnete Felder (Whale-Qualitätswert, Geld-/Briefkurs-Ungleichgewicht)

Benachrichtigungsbeispiel

Wenn eine Whale-Transaktion erkannt wird, sehen Sie eine erweiterte Ausgabe:

[ALERT] GROSSE TRANSAKTION ERKANNT - Polymarket
======================================================================
Frage:     Wird Bitcoin bis Ende 2026 100k erreichen?
Position:  KAUF von 'Ja'-Anteilen
Prognose:  Markt glaubt 'Ja' hat 65,0% Wahrscheinlichkeit

TRANSAKTIONSDETAILS
Betrag:     $50.000,00
Kontrakte:  76923,08 @ $0,6500 pro Stück
Aktion:     KAUF von Anteilen
Zeitstempel:2026-02-13T18:00:00Z

[WALLET-AKTIVITÄT]
Wallet:   0x742d35...f0bEb
Trans. (1h):  2
Trans. (24h): 5
Volumen (24h): $380.000,00
Status: SCHWERER AKTEUR (5+ Transaktionen in 24h)

[MARKTKONTEXT]
Quoten:        JA 65,0% | NEIN 35,0%
Spread:        $0,02 (eng)
24h-Volumen:   $450.000
Offenes Interesse: $2.100.000
24h-Bewegung:  +3,2%
Liquidität:    $180.000
Tags:          crypto, bitcoin

[WHALE-PROFIL]
Leaderboard:  #45 (TOP 50)
Gewinn:       +$890.000
Portfolio:    $2.340.000
Offene Pos.:  12
Gewinnrate:   73,0%
Märkte:       195

[ORDERBUCH]
Bestes Geld:   $0,6400  |  Beste Brief: $0,6600  |  Spread: $0,0200
Geldtiefe:    $45.000 (12 Stufen)  |  Brieftiefe: $38.000 (9 Stufen)
Ungleichgewicht: 54% Geld / 46% Brief (moderater Gelddruck)

[TOP-HALTER]
  #1: 0x742d...bEb — 150.000 Anteile (12,0%)
  #2: 0x8a3f...1D  — 120.000 Anteile (9,6%)
  #3: 0x5b9c...aF  — 95.000 Anteile (7,6%)
  Top 3 kontrollieren 29,2% der Anteile
======================================================================

Befehle