Whale Watcher

ПРИМЕЧАНИЕ: репозиторий превращается в полнофункционального торгового бота — openclaw-подобного агента, с которым вы общаетесь в Telegram и который может разворачивать команду агентов для проведения исследования перед принятием решения.

Rust CLI-инструмент для отслеживания крупных транзакций на рынках предсказаний Polymarket и Kalshi. Оповещения в реальном времени о значимой рыночной активности со встроенным обнаружением аномалий.

Репозиторий: 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)
Контекст рынка — коэффициенты YES/NO, спред, объём за 24 часа, открытый интерес, изменение цены, ликвидность
Нативные категории Kalshi из API (точнее, чем сопоставление по ключевым словам)
Теги Polymarket, извлекаемые из Gamma API
Обнаружение аномалий для экстремальных ставок, контрарных позиций и крупного капитала

Отслеживание кошельков

Повышенные оповещения для повторных участников (2+ транзакции за 1 час)
Приоритетные оповещения для активных участников (5+ транзакций за 24 часа)
Отслеживание объёма и частоты транзакций по каждому кошельку
Обнаружение возвращающихся китов (удвоение ставок, разворот позиций)
Постоянная память кошельков на 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-ключи не нужны — все данные берутся из публичных эндпоинтов. Оповещения о китах появятся в вашем терминале в течение нескольких секунд.

Выполните wwatcher setup, чтобы настроить платформы, категории, пороги, вебхуки и опциональные API-ключи.

Подробные инструкции по настройке и интеграции вебхуков см. в QUICKSTART.md.

Установка

Из исходников

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

Бинарный файл будет находиться по пути target/release/wwatcher. Либо установите его системно:

cargo install --path .

Информация об API

wwatcher использует 15 API-эндпоинтов в рамках 3 API Polymarket, 1 REST API Kalshi и 1 WebSocket Kalshi. Полную документацию по эндпоинтам см. в docs/API_REFERENCE.md.

Polymarket (3 API, авторизация не требуется)

API	Базовый URL	Используемые эндпоинты
Data API

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 (в реальном времени)

Все эндпоинты публичные — 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                        # Start monitoring (default: $25k threshold, 5s interval)
wwatcher watch -t 50000               # Set threshold to $50,000
wwatcher watch -t 10000 -i 10         # $10k threshold, 10s polling interval
wwatcher setup                        # 6-step guided configuration wizard
wwatcher status                       # View current configuration and DB stats
wwatcher history                      # View last 20 alerts
wwatcher history -l 50 -p polymarket  # Last 50 Polymarket alerts
wwatcher history --json               # Output alert history as JSON
wwatcher test-sound                   # Test alert sounds
wwatcher test-webhook                 # Send test webhook payloads

Подробные инструкции по настройке см. в QUICKSTART.md.

Конфигурация

Конфигурация хранится в ~/.config/wwatcher/config.json (macOS/Linux) или %APPDATA%\wwatcher\config.json (Windows).

Выполните wwatcher setup для пошагового мастера из 6 шагов, который настраивает:

Платформы — Polymarket, Kalshi или обе
Категории — Спорт, Крипто, Политика, Экономика и т. д. с детализацией по подкатегориям
Порог и хранение — Минимальный размер сделки и срок хранения истории
API-ключи — Опциональные учётные данные Kalshi
Сохранение и сводка

Документация

docs/WEBHOOK_REFERENCE.md — Полная схема полезной нагрузки вебхуков, шаблоны n8n, примеры фильтров
docs/API_REFERENCE.md — Все 15 API-эндпоинтов с примерами запросов/ответов
docs/plans/ — Проектные документы для каждого этапа реализации

Разработка

Создан с использованием:

Rust — системный язык программирования
Tokio — асинхронная среда выполнения
Reqwest — HTTP-клиент
tokio-tungstenite — WebSocket-клиент (сделки Kalshi в реальном времени)
rusqlite — база данных SQLite (история оповещений + память кошельков)
Clap — разбор аргументов командной строки
Serde — сериализация JSON
Colored — цветной вывод в терминале

Структура проекта

src/
├── main.rs              # CLI entry point (clap)
├── config.rs            # Config loading/saving
├── db.rs                # SQLite database (schema, queries, migration)
├── categories.rs        # Market category system (10 categories, 35+ subcategories)
├── whale_profile.rs     # Whale intelligence (portfolio, leaderboard, win rate)
├── types.rs             # Shared types, wallet tracker
├── alerts/
│   ├── mod.rs           # AlertData struct, payload builder
│   ├── display.rs       # Terminal output (all display functions)
│   ├── anomaly.rs       # Anomaly detection
│   ├── history.rs       # SQLite alert history
│   ├── sound.rs         # Audio alerts
│   └── webhook.rs       # Webhook sender
├── commands/
│   ├── mod.rs
│   ├── watch.rs         # Main watch loop
│   ├── setup.rs         # 6-step setup wizard
│   ├── status.rs        # Status display
│   └── test.rs          # Sound + webhook tests
├── platforms/
│   ├── mod.rs
│   ├── polymarket.rs    # Polymarket API (trades, market context, order book, top holders)
│   └── kalshi.rs        # Kalshi API (trades, market context, order book, categories)
└── ws/
    ├── mod.rs
    └── kalshi.rs         # Kalshi WebSocket client (real-time trade stream)

Устранение неполадок

Предупреждение об отсутствии конфигурации

Это нормально. Инструмент работает без конфигурации, используя публичные API. Запускайте wwatcher setup, только если хотите добавить аутентификацию Kalshi.

Ошибки API

Polymarket: публичный эндпоинт должен работать без проблем
Kalshi: публичный эндпоинт работает без аутентификации, но могут действовать ограничения частоты запросов

Ограничение частоты запросов

Если вы столкнулись с ограничением частоты запросов:

Увеличьте --interval, чтобы опрашивать реже
Для Kalshi: добавьте учётные данные API через wwatcher setup

Участники проекта

Спасибо этим участникам за их идеи и улучшения:

@fuzmik - предложил функцию записи истории оповещений

Интеграция (MCP)

wwatcher включает скоринговый MCP-сервер с двумя инструментами: score_alert и check_preferences. API-ключи не требуются.

См. integration/README.md для получения информации о настройке и инструментах.

Prowl Bot (планируется)

Разговорный Telegram-бот с многогентной командой для рынков предсказаний. Бот общается с вами, анализирует оповещения о китах и может размещать сделки на Kalshi и Polymarket после вашего одобрения.

Полный проектный документ см. в docs/plans/2026-02-25-prowl-bot-design.md.

Архитектура

You (CEO) ←→ Telegram ←→ Manager Bot
                              │
                    ┌─────────┼─────────┐
                    ▼         ▼         ▼
                Researcher  Analyst    Risk
                    └─────────┼─────────┘
                              ▼
                      Decision + Approval
                              ▼
                    Executor (Kalshi + Polymarket)

Менеджер — разговорный ИИ с индивидуальностью (soul.md), постоянной памятью и навыками. Делегирует задачи команде.
Исследователь — собирает рыночные данные, новости, тональность (ONNX)
Аналитик — читает историю китов wwatcher, оценивает оповещения, выявляет паттерны
Риск — оценивает размер позиций, управление банкроллом
Исполнитель — размещает сделки после вашего одобрения

У каждого агента есть своя душа (индивидуальность), навыки (инструкции) и память (раздел SQLite). Облачные LLM для рассуждений (OpenRouter), локальные модели для дешёвых задач (Ollama), ONNX для ML (тональность, реранкинг, временные ряды).

Дорожная карта

Постоянное обучение

Бот собирает прогнозы с первого дня. Когда рынки разрешаются, он автоматически формирует обучающие данные. Тонкая настройка локальной модели 7B (MLX на Mac, бесплатно), которая со временем становится лучше на ваших конкретных рынках. Основано на Turtel et al. 2025 — тот же подход, который достиг точности уровня o1 на Polymarket с моделью 14B.

Лицензия

Этот инструмент предназначен для образовательных целей и мониторинга. Ознакомьтесь с условиями использования API Polymarket и Kalshi.

Этап 1	Разговорный бот — Telegram, индивидуальность, память, сбор данных	Запланировано
Этап 2	Создание команды — многогентная делегация, анализ китов	Запланировано
Этап 3	Конвейер оповещений — вебхук wwatcher запускает автоматический анализ	Запланировано
Этап 4	Исполнение — размещение ордеров на Kalshi + Polymarket	Запланировано
Этап 5	ML-модели — ONNX для тональности, реранкинга, временных рядов	Запланировано
Этап 6	Постоянное обучение — Self-SFT + GRPO на результатах разрешённых рынков	Запланировано

polymaster

Популярное