Whale Watcher

NOTA: el repositorio está en transición hacia un bot de trading completo, un agente tipo openclaw con el que hablas en tu Telegram y tienes el poder de desplegar un equipo de agentes para realizar investigación antes de tomar una decisión.

Una herramienta CLI en Rust que monitorea transacciones grandes en los mercados de predicción Polymarket y Kalshi. Alertas en tiempo real para actividad significativa del mercado con detección de anomalías integrada.

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

DESCARGO DE RESPONSABILIDAD

Esta herramienta es solo para fines informativos y de investigación. Utilice estos datos únicamente para la toma de decisiones informada y el análisis de mercado.

Características

Monitoreo Principal

• Monitoreo en tiempo real de transacciones en Polymarket y Kalshi
• WebSocket de Kalshi para detección instantánea de operaciones (con respaldo de sondeo HTTP)
• Filtrado del lado del servidor de Polymarket — la API prefiltra las operaciones de ballenas, sin desperdicio de ancho de banda
• Umbral personalizable (por defecto $25,000) e intervalo de sondeo
• Alertas de sonido con triple pitido para actores repetitivos
• Filtrado por categoría de mercado (10 categorías, más de 35 subcategorías)
• Selección de plataforma (solo Polymarket, solo Kalshi, o ambas)

Inteligencia de Ballenas (Polymarket)

• Perfiles de ballenas — valor de cartera, rango en el ranking, ganancias, tasa de aciertos, posiciones abiertas
• Consulta de ranking — verifica si la billetera está entre los 500 mejores traders de Polymarket
• Memoria de billetera de 12 horas — detecta ballenas recurrentes, duplicación de posiciones y giros de ballenas
• Principales tenedores — muestra los 5 principales tenedores y su concentración de participación por mercado
• Perfiles almacenados en caché durante 30 min, ranking durante 1 hora

Inteligencia de Mercado

• Profundidad del libro de órdenes para ambas plataformas (CLOB de Polymarket + libro de órdenes de Kalshi)
• Contexto del mercado — probabilidades SÍ/NO, diferencial, volumen en 24h, interés abierto, cambio de precio, liquidez
• Categorías nativas de Kalshi desde la API (más precisas que la coincidencia de palabras clave)
• Etiquetas de Polymarket extraídas de la API Gamma
• Detección de anomalías para apuestas extremas, posiciones contrarias y capital grande

Seguimiento de Billeteras

• Alertas elevadas para actores repetitivos (2+ transacciones en 1 hora)
• Alertas de alta prioridad para actores intensivos (5+ transacciones en 24 horas)
• Rastrea volumen y frecuencia de transacciones por billetera
• Detección de ballenas recurrentes (duplicación de apuesta, giro de posición)
• Memoria persistente de billetera respaldada por SQLite a través de reinicios

Integraciones

• Notificaciones webhook a n8n, Zapier, Make, Discord o cualquier endpoint
• Payload JSON enriquecido con contexto de mercado, perfil de ballena, libro de órdenes y principales tenedores
• Servidor MCP de puntuación para puntuación de alertas y filtrado de preferencias

Infraestructura

• Base de datos SQLite para historial de alertas y memoria de billeteras
• Retención de datos configurable (7, 30, 90 días o para siempre)
• Asistente de configuración guiado de 6 pasos
• No se requieren claves API para funcionalidad básica (todos los datos públicos)
• Rápido y eficiente, construido con Rust

Inicio Rápido

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

Eso es todo. No se necesitan claves API — todos los datos provienen de endpoints públicos. Verá alertas de ballenas en su terminal en cuestión de segundos.

Ejecute wwatcher setup para configurar plataformas, categorías, umbrales, webhooks y claves API opcionales.

Consulte QUICKSTART.md para instrucciones detalladas de configuración e integración de webhook.

Instalación

Desde el Código Fuente

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

El binario estará en target/release/wwatcher. O instálelo en todo el sistema:

cargo install --path .

Información de la API

wwatcher utiliza 15 endpoints de API en 3 APIs de Polymarket, 1 API REST de Kalshi y 1 WebSocket de Kalshi. Consulte docs/API_REFERENCE.md para la documentación completa de los endpoints.

Polymarket (3 APIs, sin necesidad de autenticación)

API	URL Base	Endpoints Usados
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 (profundidad del libro de órdenes)

Kalshi (REST + WebSocket)

API	URL Base	Endpoints Usados
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 de operaciones (tiempo real)

Todos los endpoints son públicos — no se necesitan claves API. Para un acceso mejorado a Kalshi, ejecute wwatcher setup.

Integración de Webhook

wwatcher envía payloads JSON enriquecidos a cualquier URL de webhook con: contexto de mercado, perfil de ballena, profundidad del libro de órdenes, principales tenedores y actividad de billetera.

Consulte docs/WEBHOOK_REFERENCE.md para:

• Esquema completo del payload con todos los campos
• Plantillas de mensajes para n8n Telegram/Discord
• Ejemplos de filtros (actores intensivos, top 100 ballenas, solo salidas)
• Campos calculados (puntuación de calidad de ballena, desequilibrio bid/ask)

Ejemplo de Alerta

Cuando se detecta una transacción de ballena, verá una salida enriquecida:

[ALERT] TRANSACCIÓN GRANDE DETECTADA - Polymarket
======================================================================
Pregunta:    ¿Bitcoin alcanzará los 100k para finales de 2026?
Posición:    COMPRANDO acciones 'Sí'
Predicción:  El mercado cree que 'Sí' tiene un 65.0% de probabilidad

DETALLES DE LA TRANSACCIÓN
Cantidad:    $50,000.00
Contratos:   76923.08 @ $0.6500 cada uno
Acción:      COMPRAR acciones
Marca de tiempo: 2026-02-13T18:00:00Z

[ACTIVIDAD DE BILLETERA]
Billetera:   0x742d35...f0bEb
Txns (1h):   2
Txns (24h):  5
Volumen (24h): $380,000.00
Estado: ACTOR INTENSIVO (5+ transacciones en 24h)

[CONTEXTO DEL MERCADO]
Probabilidades:   SÍ 65.0% | NO 35.0%
Diferencial:       $0.02 (estrecho)
Volumen 24h:      $450,000
Interés Abierto:  $2,100,000
Movimiento 24h:   +3.2%
Liquidez:          $180,000
Etiquetas:        crypto, bitcoin

[PERFIL DE BALLENA]
Ranking:    #45 (TOP 50)
Ganancias:  +$890,000
Cartera:    $2,340,000
Pos. Abiertas: 12
Tasa de Aciertos: 73.0%
Mercados:   195

[LIBRO DE ÓRDENES]
Mejor Bid:   $0.6400  |  Mejor Ask: $0.6600  |  Diferencial: $0.0200
Profundidad Bid:  $45,000 (12 niveles)  |  Profundidad Ask: $38,000 (9 niveles)
Desequilibrio:  54% bid / 46% ask (presión bid moderada)

[PRINCIPALES TENEDORES]
  #1: 0x742d...bEb — 150,000 acciones (12.0%)
  #2: 0x8a3f...1D  — 120,000 acciones (9.6%)
  #3: 0x5b9c...aF  — 95,000 acciones (7.6%)
  Los 3 principales controlan el 29.2% de las acciones
======================================================================

Comandos