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

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

wwatcher watch                        # Überwachung starten (Standard: 25.000 $ Schwelle, 5s Intervall)
wwatcher watch -t 50000               # Schwelle auf 50.000 $ setzen
wwatcher watch -t 10000 -i 10         # 10.000 $ Schwelle, 10s Abfrageintervall
wwatcher setup                        # 6-stufiger geführter Konfigurationsassistent
wwatcher status                       # Aktuelle Konfiguration und DB-Statistiken anzeigen
wwatcher history                      # Letzte 20 Benachrichtigungen anzeigen
wwatcher history -l 50 -p polymarket  # Letzte 50 Polymarket-Benachrichtigungen
wwatcher history --json               # Benachrichtigungsverlauf als JSON ausgeben
wwatcher test-sound                   # Benachrichtigungstöne testen
wwatcher test-webhook                 # Test-Webhook-Payloads senden

Siehe QUICKSTART.md für detaillierte Einrichtungsanweisungen.

Konfiguration

Die Konfiguration wird unter ~/.config/wwatcher/config.json (macOS/Linux) oder %APPDATA%\wwatcher\config.json (Windows) gespeichert.

Führen Sie wwatcher setup für einen geführten 6-stufigen Assistenten aus, der Folgendes konfiguriert:

Plattformen – Polymarket, Kalshi oder beide
Kategorien – Sport, Krypto, Politik, Wirtschaft usw. mit Drill-Down in Unterkategorien
Schwellenwert & Aufbewahrung – Mindesthandelsgröße und Aufbewahrungsdauer des Verlaufs
API-Schlüssel – Optionale Kalshi-Anmeldedaten
Speichern & Zusammenfassung

Dokumentation

docs/WEBHOOK_REFERENCE.md – Vollständiges Webhook-Payload-Schema, n8n-Vorlagen, Filterbeispiele
docs/API_REFERENCE.md – Alle 15 API-Endpunkte mit Anfrage-/Antwortbeispielen
docs/plans/ – Designdokumente für jede Implementierungsphase

Entwicklung

Erstellt mit:

Rust – Systemprogrammiersprache
Tokio – Async-Laufzeit
Reqwest – HTTP-Client
tokio-tungstenite – WebSocket-Client (Kalshi-Echtzeit-Trades)
rusqlite – SQLite-Datenbank (Benachrichtigungsverlauf + Wallet-Speicher)
Clap – CLI-Argument-Parsing
Serde – JSON-Serialisierung
Colored – Terminal-Farbausgabe

Projektstruktur

src/
├── main.rs              # CLI-Einstiegspunkt (clap)
├── config.rs            # Konfiguration laden/speichern
├── db.rs                # SQLite-Datenbank (Schema, Abfragen, Migration)
├── categories.rs        # Marktkategoriensystem (10 Kategorien, 35+ Unterkategorien)
├── whale_profile.rs     # Whale-Intelligenz (Portfolio, Leaderboard, Gewinnrate)
├── types.rs             # Gemeinsame Typen, Wallet-Tracker
├── alerts/
│   ├── mod.rs           # AlertData-Struktur, Payload-Builder
│   ├── display.rs       # Terminal-Ausgabe (alle Anzeigefunktionen)
│   ├── anomaly.rs       # Anomalieerkennung
│   ├── history.rs       # SQLite-Benachrichtigungsverlauf
│   ├── sound.rs         # Audio-Benachrichtigungen
│   └── webhook.rs       # Webhook-Sender
├── commands/
│   ├── mod.rs
│   ├── watch.rs         # Hauptüberwachungsschleife
│   ├── setup.rs         # 6-stufiger Einrichtungsassistent
│   ├── status.rs        # Statusanzeige
│   └── test.rs          # Ton- + Webhook-Tests
├── platforms/
│   ├── mod.rs
│   ├── polymarket.rs    # Polymarket-API (Trades, Marktkontext, Orderbuch, Top-Halter)
│   └── kalshi.rs        # Kalshi-API (Trades, Marktkontext, Orderbuch, Kategorien)
└── ws/
    ├── mod.rs
    └── kalshi.rs         # Kalshi-WebSocket-Client (Echtzeit-Handelsstrom)

Fehlerbehebung

Keine Konfiguration gefunden – Warnung

Das ist normal. Das Tool funktioniert ohne Konfiguration über öffentliche APIs. Führen Sie wwatcher setup nur aus, wenn Sie eine Kalshi-Authentifizierung hinzufügen möchten.

API-Fehler

Polymarket: Öffentlicher Endpunkt sollte problemlos funktionieren
Kalshi: Öffentlicher Endpunkt funktioniert ohne Authentifizierung, aber Ratenbegrenzungen können gelten

Ratenbegrenzung

Wenn Sie ratenbegrenzt werden:

Erhöhen Sie --interval, um seltener abzufragen
Für Kalshi: API-Anmeldedaten über wwatcher setup hinzufügen

Mitwirkende

Danke an diese Mitwirkenden für ihre Ideen und Verbesserungen:

@fuzmik – Schlug die Funktion zur Protokollierung des Benachrichtigungsverlaufs vor

Integration (MCP)

wwatcher enthält einen Scoring-MCP-Server mit zwei Tools: score_alert und check_preferences. Keine API-Schlüssel erforderlich.

Siehe integration/README.md für Einrichtung und Tool-Details.

Prowl Bot (Geplant)

Ein konversationeller Telegram-Bot mit einem Multi-Agenten-Prognosemarkt-Team. Der Bot spricht mit Ihnen, analysiert Whale-Benachrichtigungen und kann nach Ihrer Zustimmung Trades auf Kalshi und Polymarket platzieren.

Siehe docs/plans/2026-02-25-prowl-bot-design.md für das vollständige Designdokument.

Architektur

Sie (CEO) ←→ Telegram ←→ Manager-Bot
                              │
                    ┌─────────┼─────────┐
                    ▼         ▼         ▼
                Researcher  Analyst    Risk
                    └─────────┼─────────┘
                              ▼
                      Entscheidung + Zustimmung
                              ▼
                    Ausführer (Kalshi + Polymarket)

Manager – konversationelle KI mit Persönlichkeit (soul.md), persistentem Speicher und Fähigkeiten. Delegiert an das Team.
Researcher – sammelt Marktdaten, Nachrichten, Stimmung (ONNX)
Analyst – liest wwatcher-Whale-Verlauf, bewertet Benachrichtigungen, erkennt Muster
Risk – bewertet Positionsgröße, Bankroll-Management
Executor – platziert Trades nach Ihrer Zustimmung

Jeder Agent hat eine eigene Seele (Persönlichkeit), Fähigkeiten (Anweisungen) und Speicher (SQLite-Partition). Cloud-LLMs für Reasoning (OpenRouter), lokale Modelle für günstige Aufgaben (Ollama), ONNX für ML (Stimmung, Re-Ranking, Zeitreihen).

Roadmap

Kontinuierliches Lernen

Der Bot sammelt ab dem ersten Tag Vorhersagen. Wenn Märkte aufgelöst werden, erstellt er automatisch Trainingsdaten. Feintuning eines lokalen 7B-Modells (MLX auf Mac, kostenlos), das bei Ihren spezifischen Märkten mit der Zeit besser wird. Basierend auf Turtel et al. 2025 – derselbe Ansatz, der mit einem 14B-Modell die o1-Genauigkeit auf Polymarket erreicht hat.

Lizenz

Dieses Tool dient Bildungs- und Überwachungszwecken. Überprüfen Sie die Nutzungsbedingungen der Polymarket- und Kalshi-APIs.

Phase 1	Sprechender Bot – Telegram, Persönlichkeit, Speicher, Datensammlung	Geplant
Phase 2	Team-Spawning – Multi-Agenten-Delegation, Whale-Analyse	Geplant
Phase 3	Alert-Pipeline – wwatcher-Webhook löst Auto-Analyse aus	Geplant
Phase 4	Ausführung – Kalshi + Polymarket Orderplatzierung	Geplant
Phase 5	ML-Modelle – ONNX Stimmung, Re-Ranker, Zeitreihen	Geplant
Phase 6	Kontinuierliches Lernen – Self-SFT + GRPO auf aufgelösten Marktergebnissen	Geplant

polymaster

Beliebteste