Whale Watcher

NOTE : le dépôt est en transition vers un bot de trading complet, un agent de type openclaw avec lequel vous discutez dans votre Telegram, capable de déployer une équipe d'agents pour effectuer des recherches avant de prendre une décision.

Un outil CLI en Rust qui surveille les transactions importantes sur les marchés de prédiction Polymarket et Kalshi. Alertes en temps réel pour les activités de marché significatives, avec détection d'anomalies intégrée.

Dépôt : https://github.com/neur0map/polymaster

AVERTISSEMENT

Cet outil est fourni à des fins d'information et de recherche uniquement. Utilisez ces données uniquement pour une prise de décision éclairée et une analyse de marché.

Fonctionnalités

Surveillance principale

• Surveillance en temps réel des transactions Polymarket et Kalshi
• WebSocket Kalshi pour une détection instantanée des échanges (avec repli HTTP par requêtes)
• Filtrage côté serveur Polymarket — L'API pré-filtre les transactions des baleines, aucune bande passante gaspillée
• Seuil personnalisable (par défaut 25 000 $) et intervalle d'interrogation
• Alertes sonores avec triple bip pour les acteurs récurrents
• Filtrage par catégorie de marché (10 catégories, 35+ sous-catégories)
• Sélection de plateforme (Polymarket uniquement, Kalshi uniquement, ou les deux)

Intelligence des baleines (Polymarket)

• Profils de baleines — valeur du portefeuille, rang dans le classement, profit, taux de victoire, positions ouvertes
• Recherche dans le classement — vérifie si le portefeuille fait partie des 500 meilleurs traders Polymarket
• Mémoire de portefeuille sur 12 heures — détecte les baleines de retour, le doublement de position et les retournements de baleines
• Principaux détenteurs — affiche les 5 principaux détenteurs et leur concentration de parts par marché
• Profils mis en cache pendant 30 minutes, classement mis en cache pendant 1 heure

Intelligence de marché

• Profondeur du carnet d'ordres pour les deux plateformes (CLOB Polymarket + carnet d'ordres Kalshi)
• Contexte du marché — cotes OUI/NON, écart, volume sur 24 h, intérêt ouvert, variation de prix, liquidité
• Catégories Kalshi natives issues de l'API (plus précises que la correspondance par mots-clés)
• Balises Polymarket extraites de l'API Gamma
• Détection d'anomalies pour les paris extrêmes, les positions contraires et les capitaux importants

Suivi des portefeuilles

• Alertes élevées pour les acteurs récurrents (2+ transactions en 1 heure)
• Alertes haute priorité pour les gros acteurs (5+ transactions en 24 heures)
• Suivi du volume et de la fréquence des transactions par portefeuille
• Détection des baleines de retour (doublement de mise, retournement de position)
• Mémoire persistante des portefeuilles basée sur SQLite, même après redémarrage

Intégrations

• Notifications Webhook vers n8n, Zapier, Make, Discord ou tout point de terminaison
• Payload JSON riche avec contexte de marché, profil de baleine, carnet d'ordres et principaux détenteurs
• Serveur MCP de notation pour la notation des alertes et le filtrage des préférences

Infrastructure

• Base de données SQLite pour l'historique des alertes et la mémoire des portefeuilles
• Conservation configurable des données (7, 30, 90 jours ou indéfiniment)
• Assistant de configuration guidé en 6 étapes
• Aucune clé API requise pour les fonctionnalités de base (toutes les données sont publiques)
• Rapide et efficace, construit avec Rust

Démarrage rapide

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

C'est tout. Aucune clé API nécessaire — toutes les données proviennent de points de terminaison publics. Vous verrez des alertes de baleines dans votre terminal en quelques secondes.

Exécutez wwatcher setup pour configurer les plateformes, catégories, seuils, webhooks et clés API optionnelles.

Consultez QUICKSTART.md pour des instructions d'installation détaillées et l'intégration webhook.

Installation

Depuis les sources

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

Le binaire se trouvera dans target/release/wwatcher. Ou installez-le à l'échelle du système :

cargo install --path .

Informations sur l'API

wwatcher utilise 15 points de terminaison API répartis sur 3 API Polymarket, 1 API REST Kalshi et 1 WebSocket Kalshi. Voir docs/API_REFERENCE.md pour la documentation complète des points de terminaison.

Polymarket (3 API, aucune authentification requise)

API	URL de base	Points de terminaison utilisés
Data API	data-api.polymarket.com	trades, value, positions, closed-positions, leaderboard, top-holders
Gamma API	gamma-api.polymarket.com	markets (contexte + balises)
CLOB API	clob.polymarket.com	book (profondeur du carnet d'ordres)

Kalshi (REST + WebSocket)

API	URL de base	Points de terminaison utilisés
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	canal trade (temps réel)

Tous les points de terminaison sont publics — aucune clé API nécessaire. Pour un accès amélioré à Kalshi, exécutez wwatcher setup.

Intégration Webhook

wwatcher envoie des payloads JSON riches vers n'importe quelle URL de webhook, contenant : contexte de marché, profil de baleine, profondeur du carnet d'ordres, principaux détenteurs et activité du portefeuille.

Voir docs/WEBHOOK_REFERENCE.md pour :

• Le schéma complet du payload avec tous les champs
• Les modèles de messages n8n Telegram/Discord
• Des exemples de filtres (gros acteurs, top 100 des baleines, sorties uniquement)
• Les champs calculés (score de qualité de la baleine, déséquilibre offre/demande)

Exemple d'alerte

Lorsqu'une transaction de baleine est détectée, vous verrez une sortie enrichie :

[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
======================================================================

Commandes