概要

polymarket-whales は、Polymarket の CLOB（中央限月板）API を監視して、設定した金額以上の「ホエール（大口）」取引を検知した瞬間に通知を行うシンプルな CLI ツールです。ターミナル上で即時にアラートを表示するだけでなく、Telegram ボットを通じたプッシュ通知にも対応しており、自動トラッキングやストラテジーのインプットに使えます。設定は .env で行い、軽量な Python 実装のためローカルや小規模サーバで手軽に動かせます。

リポジトリの統計情報

• スター数: 20
• フォーク数: 1
• ウォッチャー数: 20
• コミット数: 15
• ファイル数: 9
• メインの言語: Python

主な特徴

• Polymarket の CLOB API をリアルタイム監視し、設定した閾値を超える取引を検出
• ターミナルでの即時アラート表示（CLI）
• Telegram ボット経由での通知送信をサポート
• 環境変数（.env）による簡単な設定と導入のしやすさ

技術的なポイント

本プロジェクトは Python を主体とした小規模なコードベースで、リアルタイム検知と通知に特化しています。README の説明からは「CLOB API を監視し、取引額が閾値を超えたらアラートを発火する」動作が明示されており、実装上は API のストリーミング（WebSocket 等）または短周期ポーリングで最新の約定データを取得していると考えられます。設定は .env ファイルで行う形式になっており、Telegram の Bot Token やチャット ID、監視する最小取引額（しきい値）などを外部化して安全に運用できます。

通知機能は主に二種類（ターミナル表示と Telegram 通知）で、CLI 実行中は標準出力に要約を出し、必要に応じて Telegram 経由でモバイルやサーバにプッシュするワークフローが想定されます。構造的には監視ループ → 取引フィルタリング（しきい値/資産/市場）→ 通知モジュールという分離がされていれば拡張やテストが容易です。軽量で依存関係も少なめに設計されているため、ローカル環境や小型 VPS での常駐運用に向いています。セキュリティ面では API トークン類を .env で管理する点、通知先が外部サービス（Telegram）である点に留意し、トークンの漏洩対策や最小権限の設定が重要です。

拡張アイデアとしては：

• Web UI やダッシュボードへの統合
• 取引の履歴保存と集計（何時にどの市場で誰が買ったか等の追跡は難しいが、匿名化された履歴は可能）
• 複数市場や複数しきい値の同時監視 などが考えられます。

プロジェクトの構成

主要なファイルとディレクトリ：

• .env.example: file
• .gitignore: file
• LICENSE: file
• README.md: file
• assets: dir

…他 4 ファイル

（注：assets ディレクトリにはデモ GIF 等の視覚素材が含まれています）

まとめ

シンプルで導入しやすい、Polymarket の大口動向を捉える実用的な監視ツールです。（約50字）

リポジトリ情報：

• 名前: polymarket-whales
• 説明: 🐋 Real-time whale trade tracker for Polymarket — get terminal alerts + Telegram notifications when smart money moves
• スター数: 20
• 言語: Python
• URL: https://github.com/al1enjesus/polymarket-whales
• オーナー: al1enjesus
• アバター: https://avatars.githubusercontent.com/u/72158359?v=4

READMEの抜粋：

---

What is this?

polymarket-whales monitors the Polymarket CLOB API and fires an alert the moment a trade above your t…