neur0map/polymasterPolymarketとKalshiの予測市場で、異常検知を備えた大口取引の監視
注意: このリポジトリは、Telegram 上で会話できるフル機能のトレーディングボット（openclaw 風エージェント）へ移行中です。意思決定の前に調査を行うエージェントチームを展開する機能を備えています。
Polymarket と Kalshi の予測市場で大口取引を監視する Rust 製 CLI ツール。異常検知を内蔵し、重要な市場アクティビティをリアルタイムでアラートします。
リポジトリ: https://github.com/neur0map/polymaster
このツールは情報提供および調査目的のみで使用されます。このデータは、情報に基づく意思決定と市場分析のためだけに使用してください。
git clone https://github.com/neur0map/polymaster.git
cd polymaster
cargo install --path .
wwatcher watch
これだけです。API キーは不要です。すべてのデータは公開エンドポイントから取得されます。数秒以内にターミナルでホエールアラートが表示されます。
プラットフォーム、カテゴリ、しきい値、webhook、オプションの API キーを設定するには wwatcher setup を実行してください。
詳細なセットアップ手順と webhook 統合については QUICKSTART.md を参照してください。
git clone https://github.com/neur0map/polymaster.git
cd polymaster
cargo build --release
バイナリは target/release/wwatcher に生成されます。または、システム全体にインストールします:
cargo install --path .
wwatcher は、3 つの Polymarket API、1 つの Kalshi REST API、1 つの Kalshi WebSocket にわたる15 の API エンドポイントを使用します。完全なエンドポイントドキュメントについては docs/API_REFERENCE.md を参照してください。
| API | ベース URL | 使用エンドポイント |
|---|---|---|
| Data API | data-api.polymarket.com |
| 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 は、市場コンテキスト、ホエールプロファイル、オーダーブック深度、トップホルダー、ウォレットアクティビティを含むリッチな JSON ペイロードを任意の webhook URL に送信します。
docs/WEBHOOK_REFERENCE.md には以下が含まれます:
ホエール取引が検出されると、リッチ化された出力が表示されます:
[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 # 監視を開始（デフォルト: 25,000 ドルのしきい値、5 秒間隔）
wwatcher watch -t 50000 # しきい値を 50,000 ドルに設定
wwatcher watch -t 10000 -i 10 # 1 万ドルのしきい値、10 秒のポーリング間隔
wwatcher setup # 6 ステップのガイド付き設定ウィザード
wwatcher status # 現在の設定と DB 統計を表示
wwatcher history # 直近 20 件のアラートを表示
wwatcher history -l 50 -p polymarket # 直近 50 件の Polymarket アラート
wwatcher history --json # アラート履歴を JSON で出力
wwatcher test-sound # アラートサウンドをテスト
wwatcher test-webhook # テスト用 webhook ペイロードを送信
詳細なセットアップ手順については QUICKSTART.md を参照してください。
設定は ~/.config/wwatcher/config.json（macOS/Linux）または %APPDATA%\wwatcher\config.json（Windows）に保存されます。
wwatcher setup を実行すると、以下を設定する 6 ステップのガイド付きウィザードが起動します:
docs/WEBHOOK_REFERENCE.md — 完全な webhook ペイロードスキーマ、n8n テンプレート、フィルタ例docs/API_REFERENCE.md — リクエスト/レスポンス例付きの全 15 API エンドポイントdocs/plans/ — 各実装フェーズの設計ドキュメント使用技術:
src/
├── main.rs # CLI エントリポイント (clap)
├── config.rs # 設定の読み込み/保存
├── db.rs # SQLite データベース (スキーマ、クエリ、マイグレーション)
├── categories.rs # 市場カテゴリシステム (10 カテゴリ、35 以上のサブカテゴリ)
├── whale_profile.rs # ホエールインテリジェンス (ポートフォリオ、リーダーボード、勝率)
├── types.rs # 共有型、ウォレットトラッカー
├── alerts/
│ ├── mod.rs # AlertData 構造体、ペイロードビルダー
│ ├── display.rs # ターミナル出力 (すべての表示関数)
│ ├── anomaly.rs # 異常検知
│ ├── history.rs # SQLite アラート履歴
│ ├── sound.rs # オーディオアラート
│ └── webhook.rs # Webhook 送信
├── commands/
│ ├── mod.rs
│ ├── watch.rs # メインの監視ループ
│ ├── setup.rs # 6 ステップのセットアップウィザード
│ ├── status.rs # ステータス表示
│ └── test.rs # サウンド + webhook テスト
├── platforms/
│ ├── mod.rs
│ ├── polymarket.rs # Polymarket API (取引、市場コンテキスト、オーダーブック、トップホルダー)
│ └── kalshi.rs # Kalshi API (取引、市場コンテキスト、オーダーブック、カテゴリ)
└── ws/
├── mod.rs
└── kalshi.rs # Kalshi WebSocket クライアント (リアルタイム取引ストリーム)
これは正常です。このツールは公開 API を使用して設定なしで動作します。Kalshi の認証を追加したい場合のみ wwatcher setup を実行してください。
レート制限を受ける場合:
--interval を増やしてポーリング頻度を下げるwwatcher setup で API 認証情報を追加するアイデアと改善を提供してくれたコントリビューターに感謝します:
wwatcher には、score_alert と check_preferences の 2 つのツールを備えたスコアリング MCP サーバーが含まれています。API キーは不要です。
セットアップとツールの詳細については integration/README.md を参照してください。
マルチエージェントの予測市場チームを備えた対話型 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)
各エージェントは独自のソウル（性格）、スキル（指示）、メモリ（SQLite パーティション）を持ちます。推論にはクラウド LLM（OpenRouter）、低コストタスクにはローカルモデル（Ollama）、ML には ONNX（センチメント、リランキング、時系列）を使用します。
ボットは初日から予測を収集します。市場が確定すると、自動的にトレーニングデータを構築します。ローカルの 7B モデル（Mac では MLX、無料）をファインチューニングして、時間の経過とともに特定の市場で向上させることができます。Turtel et al. 2025 に基づく手法で、14B モデルで Polymarket の o1 精度に匹敵したものと同じアプローチです。
このツールは教育および監視目的で提供されます。Polymarket および Kalshi API の利用規約を確認してください。
| trades、value、positions、closed-positions、leaderboard、top-holders |
| Gamma API | gamma-api.polymarket.com | markets（コンテキスト + タグ） |
| CLOB API | clob.polymarket.com | book（オーダーブック深度） |
| フェーズ | 説明 | ステータス |
|---|
| フェーズ 1 | 会話型ボット — Telegram、性格、メモリ、データ収集 | 計画中 |
| フェーズ 2 | チーム生成 — マルチエージェント委任、ホエール分析 | 計画中 |
| フェーズ 3 | アラートパイプライン — wwatcher webhook が自動分析をトリガー | 計画中 |
| フェーズ 4 | 実行 — Kalshi + Polymarket の注文発注 | 計画中 |
| フェーズ 5 | ML モデル — ONNX センチメント、リランカー、時系列 | 計画中 |
| フェーズ 6 | 継続学習 — 確定した市場結果に対する Self-SFT + GRPO | 計画中 |