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	data-api.polymarket.com	trades, value, positions, closed-positions, leaderboard, top-holders
Gamma API	gamma-api.polymarket.com	markets (контекст + теги)
CLOB API	clob.polymarket.com	book (глубина книги заказов)

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.

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