🐳 polyterm実動チュートリアル｜ターミナルだけでPolymarketクジラ追跡（インストール〜実行まで）
Polymarketの市場をターミナルだけで分析したい人向けのハンズオンです。ブラウザ不要・秘密鍵不要で、クジラの動きも裁定機会も全部コマンド一発で見えます。
この記事で動かすコマンドは全部Windows機で実行確認済み。実出力をそのまま貼ってます。
polytermとは
NYTEMODEONLY/polyterm — Python製、MITライセンス、975個のテスト付きという本格派のPolymarket分析CLIです。
- 20+ 分析機能（クジラ追跡、インサイダー検知、アービトラージ、ウォッシュトレード検知など）
- 秘密鍵を一切触らない設計（ウォレット機能は閲覧専用）
- SQLiteでブックマーク・アラート・トレード日記をローカル保存
💡 「秘密鍵を触らない」が超重要。2025年12月には
polymarket-copy-trading-botを名乗るGitHubリポに秘密鍵抽出マルウェアが仕込まれていた事件があります。閲覧専用設計のツールから始めるのが鉄則です。
インストール（3つの選択肢）
公式READMEで案内されてる順：
# Option 1: pipx（推奨・最もクリーン）pipx install polyterm
# Option 2: ワンコマンドcurl -sSL https://raw.githubusercontent.com/NYTEMODEONLY/polyterm/main/install.sh | bash
# Option 3: clone + pip installgit clone https://github.com/NYTEMODEONLY/polyterm.gitcd polytermpip install -e .既存の仮想環境があれば流用するのが早い：
python -m venv .venv.venv/Scripts/pip install -e path/to/polytermインストールは2〜3分で完了。依存関係はgql, aiohttp, rich（TUI）, pytestなど普通のPythonパッケージです。
⚠️ Windowsのつまずき: 実行前に
set PYTHONIOENCODING=utf-8を必ず。じゃないとrichの罫線文字でUnicodeEncodeErrorが出ます。
疎通確認
polyterm --help実出力（長いので抜粋）：
Usage: polyterm [OPTIONS] COMMAND [ARGS]...
PolyTerm - Terminal-based monitoring for PolyMarket
Commands: alerts View and manage alerts analyze Analyze your portfolio for exposure and risk arbitrage Scan for arbitrage opportunities across markets backtest Backtest trading strategies on historical data chart Display price history chart for a market clusters Detect wallet clusters (same entity controlling multiple wallets) crypto15m Monitor 15-minute crypto prediction markets (BTC, ETH, SOL, XRP) dashboard Quick overview of market activity depth Analyze order book depth and estimate slippage ev Calculate expected value and optimal position size follow Manage followed wallets for copy trading whales Volume-based whale detection ...（40+コマンド）40以上のサブコマンド。多すぎて最初は呆然とします😂 まずは3つだけ覚えれば十分です：dashboard / whales / arbitrage。
コマンド① dashboard — まず全体像
polyterm dashboard実出力（2026-04-11 15:06実行）：
┌─────────────────────────────────────────────────────────────────────────────┐│ PolyTerm Dashboard ││ Saturday, April 11, 2026 15:06 │└─────────────────────────────────────────────────────────────────────────────┘
Top Volume Markets (24h) # Market Volume Prob 1 Will the San Antonio Spurs win the 2026 NBA F $503,863 16% 2 Will the Los Angeles Lakers win the 2026 NBA $140,729 1% 3 Will the Orlando Magic win the 2026 NBA Final $126,053 0% 4 Will the Houston Rockets win the 2026 NBA Fin $115,449 2% 5 Will the Golden State Warriors win the 2026 N $109,659 0%
┌─── Bookmarks ────┐ ┌───── Alerts ─────┐ ┌─── Following ────┐│ None yet │ │ All clear │ │ None yet │└──────────────────┘ └──────────────────┘ └──────────────────┘1コマンドで「今日Polymarketで何が盛り上がってるか」が一発で見えます。NBAファイナル2026の市場で$500K以上の出来高、Spursが16%確率で動いている…みたいな情報が無料で取れます。Bloombergの代わりになります。
コマンド② whales — クジラ追跡
polyterm whales --limit 5実出力：
Tracking high-volume markets ≥ $10,000Period: Last 24 hours
High Volume Markets (Last 24h)┌───────────────────────────────────────────┬───────┬────────────┬────────────┐│ Market │ Trend │ Last Price │ 24h Volume │├───────────────────────────────────────────┼───────┼────────────┼────────────┤│ Will the San Antonio Spurs win the 2026 │ NO │ $0.160 │ $503,863 ││ NBA Finals │ │ │ ││ Will the Los Angeles Lakers win the 2026 │ NO │ $0.013 │ $140,729 ││ NBA Final │ │ │ ││ Will the Orlando Magic win the 2026 NBA │ NO │ $0.003 │ $126,388 ││ Finals? │ │ │ ││ Will the Houston Rockets win the 2026 NBA │ NO │ $0.026 │ $115,778 ││ Finals? │ │ │ ││ Will the Golden State Warriors win the │ NO │ $0.001 │ $109,988 ││ 2026 NBA Fi │ │ │ │└───────────────────────────────────────────┴───────┴────────────┴────────────┘
Summary: High-volume markets: 5 Total 24hr volume: $996,746 Average per market: $199,349📘 読み方:
Trend=NO＝ 「市場はNOに傾いてる」。LakersはYESが$0.013（1%確率）でほぼ優勝絶望と見られてます。SpursのYESは$0.16で「まだ可能性あり」と見られている、のような読み方ができます。
注意：このコマンドは市場単位の出来高を見ます。「個別のクジラウォレット」を追いたい場合はfollowコマンドを使います（後述）。
コマンド③ arbitrage — 裁定機会
polyterm arbitrage --limit 5実出力：
Scanning for arbitrage opportunities (min spread: 2.5%)...
┌──────────────────────── No Arbitrage Opportunities ─────────────────────────┐│ No arbitrage opportunities found at current spread levels. ││ ││ Suggestion: Try lowering the minimum spread with --min-spread, or check ││ back later. │└─────────────────────────────────────────────────────────────────────────────┘健全な市場の証拠です。2.5%以上のスプレッドがある裁定は今この瞬間は存在しない＝マーケットメーカー達がちゃんと仕事してるということ。--min-spread 0.5とかに下げれば薄い機会は見つかりますが、手数料とスリッページでだいたい消えます。
裁定で稼ぎたい初心者の現実：ほぼ無理。bot勢が秒単位で拾ってくので、手動で勝てる市場じゃありません。ただし「今の市場効率がどれくらいか」の指標としては超有用です。
他の便利コマンド（使い所だけ）
| コマンド | 使い所 |
|---|---|
polyterm chart <slug> | 特定市場の価格履歴をASCIIチャートで表示 |
polyterm depth <slug> | 板の深さ・想定スリッページを試算 |
polyterm ev <slug> | 期待値とケリー基準の最適サイズを計算 |
polyterm follow <wallet> | 特定ウォレットをウォッチリストに登録（閲覧専用） |
polyterm clusters | 同一人物の複数ウォレットを検出 |
polyterm crypto15m | BTC/ETH/SOL/XRPの15分市場リアルタイム監視 |
polyterm backtest | 戦略バックテスト |
clustersが地味にすごくて、「違うウォレットに見えるけど資金流入パターンから同一人物」と判定してくれます。PolymarketはPolygon上で全取引が公開されてるので、こういう分析ができるんです。株式市場では不可能。
つまずきポイント集
| 症状 | 対処 |
|---|---|
UnicodeEncodeError: 'cp932' | set PYTHONIOENCODING=utf-8 |
pipxが入ってない | python -m pip install --user pipx → python -m pipx ensurepath |
polyterm whalesが空 | --min-volume 1000 に下げる、または--period 24h |
arbitrageが全部0 | 正常。市場が効率的な証拠。--min-spread 0.5で薄い機会は見れる |
crypto15mが無限待ち | Ctrl+Cで抜ける。これはリアルタイムモニタなので終了しないのが正常 |
注意：秘密鍵を要求する機能は使わない
polytermはデフォルトで閲覧専用ですが、一部のコマンドは実取引のために秘密鍵を要求します。初心者は絶対に触らないでください。以下のワークフローを推奨：
- 最初の2週間:
dashboard/whales/chart/depthだけ使う（全部閲覧専用） - 次の2週間:
evで期待値を計算して、紙の上でポジション妄想 - 1ヶ月後: Polymarket公式サイトで手動で$50だけ入金
- 秘密鍵を入れるCLI機能は永久に触らないのが一番安全
秘密鍵を入れる必要はありません。取引はWebブラウザからでも十分です。polytermは分析ツールとして使いましょう。
まとめ
polytermは975テスト付き・閲覧専用設計の安全なPolymarket分析CLIpip install -e .で3分、実際にWindowsで動作確認済みdashboard/whales/arbitrageの3コマンドだけでも十分強力- NBAファイナル2026市場で$500K以上の出来高がリアルタイムで見える
- 秘密鍵を要求する機能は使わない。分析は分析、取引はブラウザ、と分けるのが鉄則
派手な機能より、閲覧専用の分析ツールをローカルで動かすほうが初心者には圧倒的に安全で、プロと同じデータが取れます。Polymarketの強みはPolygon上で全取引が公開されていることで、その生データを自分のマシンに引き込むだけで、Bloomberg並みのダッシュボードが手に入ります🔥
参考リンク
🎁おすすめツール・サービス
※上記リンクにはプロモーション（広告）が含まれています
量子相場謀略｜ホソノP
ブログでは書けない本音のトレード戦略とEA開発の裏側を公開。 データに基づいた検証で、再現性のある手法だけをお届けします。