Whale Watcher

참고: 이 저장소는 완전한 기능을 갖춘 트레이딩 봇으로 전환 중입니다. Telegram에서 대화하며, 결정을 내리기 전에 연구를 수행할 에이전트 팀을 배포할 수 있는 OpenClaw 유사 에이전트입니다.

Polymarket 및 Kalshi 예측 시장의 대규모 거래를 모니터링하는 Rust CLI 도구입니다. 내장된 이상 징후 탐지 기능으로 중요한 시장 활동에 대한 실시간 알림을 제공합니다.

저장소: https://github.com/neur0map/polymaster

면책 고지

이 도구는 정보 제공 및 연구 목적 전용입니다. 이 데이터는 정보에 입각한 의사 결정 및 시장 분석에만 사용하세요.

기능

핵심 모니터링

Polymarket 및 Kalshi 거래 실시간 모니터링
즉각적인 거래 감지를 위한 Kalshi WebSocket (HTTP 폴링 폴백)
Polymarket 서버 측 필터링 — API가 고래 거래를 사전 필터링하므로 대역폭 낭비가 없습니다
사용자 지정 가능한 임계값(기본 $25,000) 및 폴링 간격
반복 행위자에 대한 3중 경고음 오디오 알림
시장 카테고리 필터링(10개 카테고리, 35개 이상의 하위 카테고리)
플랫폼 선택(Polymarket만, Kalshi만, 또는 둘 다)

고래 인텔리전스 (Polymarket)

고래 프로필 — 포트폴리오 가치, 리더보드 순위, 수익, 승률, 미결제 포지션
리더보드 조회 — 지갑이 Polymarket 상위 500대 트레이더에 포함되는지 확인
12시간 지갑 메모리 — 재방문 고래, 포지션 두 배 확대, 고래 포지션 반전 감지
상위 보유자 — 시장별 상위 5대 보유자와 지분 집중도 표시
프로필은 30분, 리더보드는 1시간 캐시됨

시장 인텔리전스

두 플랫폼 모두에 대한 호가창 깊이 (Polymarket CLOB + Kalshi orderbook)
시장 컨텍스트 — YES/NO 배당률, 스프레드, 24시간 거래량, 미결제 약정, 가격 변동, 유동성
API의 네이티브 Kalshi 카테고리 (키워드 매칭보다 정확)
Gamma API에서 추출한 Polymarket 태그
극단적 베팅, 역방향 포지션, 대규모 자본에 대한 이상 징후 탐지

지갑 추적

반복 행위자에 대한 상향 알림 (1시간 내 2회 이상 거래)
대량 행위자에 대한 높은 우선순위 알림 (24시간 내 5회 이상 거래)
지갑별 거래량 및 거래 빈도 추적
재방문 고래 감지 (추가 베팅, 포지션 반전)
재시작 후에도 유지되는 SQLite 기반 영구 지갑 메모리

통합

n8n, Zapier, Make, Discord 또는 모든 엔드포인트로 웹훅 알림
시장 컨텍스트, 고래 프로필, 호가창, 상위 보유자가 포함된 풍부한 JSON 페이로드
알림 점수 산정 및 선호도 필터링을 위한 Scoring 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는 3개의 Polymarket API, 1개의 Kalshi REST API, 1개의 Kalshi WebSocket에서 15개의 API 엔드포인트를 사용합니다. 전체 엔드포인트 문서는 docs/API_REFERENCE.md를 참조하세요.

Polymarket (인증 불필요한 API 3개)

API	기본 URL	사용 엔드포인트
Data API	`data-api.polymarket.com`

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 channel (실시간)

모든 엔드포인트는 공개되어 있습니다 — API 키가 필요 없습니다. 향상된 Kalshi 액세스를 원한다면 wwatcher setup을 실행하세요.

웹훅 통합

wwatcher는 시장 컨텍스트, 고래 프로필, 호가창 깊이, 상위 보유자, 지갑 활동이 포함된 풍부한 JSON 페이로드를 모든 웹훅 URL로 전송합니다.

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 — CLI 인수 파싱
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를 사용하여 구성 없이도 작동합니다. Kalshi 인증을 추가하려는 경우에만 wwatcher setup을 실행하세요.

API 오류

Polymarket: 공개 엔드포인트는 문제없이 작동합니다
Kalshi: 공개 엔드포인트는 인증 없이 작동하지만, 속도 제한이 적용될 수 있습니다

속도 제한

속도 제한이 발생하는 경우:

폴링 빈도를 낮추려면 --interval을 늘리세요
Kalshi의 경우: wwatcher setup을 통해 API 자격 증명을 추가하세요

기여자

아이디어와 개선 사항을 제공해 주신 기여자분들께 감사드립니다:

@fuzmik - 알림 기록 로깅 기능 제안

통합 (MCP)

wwatcher에는 score_alert 및 check_preferences라는 두 가지 도구가 있는 스코어링 MCP 서버가 포함되어 있습니다. 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)

Manager — 개성(soul.md), 영구 메모리, 스킬을 갖춘 대화형 AI. 팀에 작업을 위임합니다.
Researcher — 시장 데이터, 뉴스, 심리 수집 (ONNX)
Analyst — wwatcher 고래 기록을 읽고, 알림 점수를 산정하며, 패턴을 감지합니다
Risk — 포지션 규모 및 자금 관리 평가
Executor — 사용자 승인 후 거래 실행

각 에이전트는 고유한 소울(개성), 스킬(지침), 메모리(SQLite 파티션)를 보유합니다. 추론에는 클라우드 LLM(OpenRouter), 저비용 작업에는 로컬 모델(Ollama), ML에는 ONNX(심리 분석, 재순위화, 시계열)를 사용합니다.

로드맵

지속적 학습

봇은 첫날부터 예측을 수집합니다. 시장이 해소되면 자동으로 훈련 데이터를 구축합니다. 시간이 지남에 따라 특정 시장에 더 특화되는 로컬 7B 모델(Mac의 MLX, 무료)을 파인튜닝하세요. Turtel et al. 2025 기반 — 14B 모델로 Polymarket에서 o1 정확도에 근접했던 것과 동일한 접근 방식입니다.

라이선스

이 도구는 교육 및 모니터링 목적으로 사용됩니다. Polymarket 및 Kalshi API의 서비스 약관을 검토하세요.

1단계	대화형 봇 — Telegram, 개성, 메모리, 데이터 수집	계획됨
2단계	팀 생성 — 멀티 에이전트 위임, 고래 분석	계획됨
3단계	알림 파이프라인 — wwatcher 웹훅이 자동 분석 트리거	계획됨
4단계	실행 — Kalshi + Polymarket 주문 배치	계획됨
5단계	ML 모델 — ONNX 심리 분석, 재순위화, 시계열	계획됨
6단계	지속적 학습 — 해소된 시장 결과에 대한 Self-SFT + GRPO	계획됨

polymaster

인기