Communitygithub.com

mvanhorn/clawdbot-skill-polymarket

Polymarket の予測市場をターミナルから操作。オッズ確認、ポートフォリオ管理、AI を活用した市場調査、市場比較、取引までをカバー。4つの Polymarket API(Gamma、CLOB、Data API、RTDS WebSocket、Bridge)すべてに対応。読み取り専用コマンドは即座に使用可能(セットアップ不要)。ClawHub で最も包括的な予測市場スキルです。

clawdbot-skill-polymarket とは?

このスキルは、Polymarket の予測市場をターミナルから完全に操作できるように設計されています。AI エージェント(Claude Code、Cursor、Codex など)向けに最適化されており、ユーザーは自然言語を使ってオッズの閲覧、イベントの調査、市場の比較、ポートフォリオの追跡、ライブデータのストリーミング、資金のブリッジ、そして取引の実行までをシームレスに行えます。 このスキルの最大の強みは、Polymarket が公開する 4 つの API(Gamma、CLOB、Data API、RTDS WebSocket)と Bridge API をすべてカバーしている点です。読み取り専用の操作(トレンド市場の表示、検索、イベント情報の取得、カテゴリ別ブラウズ、市場比較、市場調査)は、CLI のインストールを必要とせず、即座に実行できます。一方、注文簿の確認、価格履歴の取得、ポートフォリオ管理、実際の取引など高度な機能を使用する場合は、Polymarket CLI(Rust バイナリ)をインストールし、ウォレットを設定する必要があります。 具体的には、以下の機能を提供します。トレンド市場ダッシュボード(カテゴリ別に分類)、詳細な市場調査レポート(オッズ分析、出来高、流動性、トレンド、コンテキスト、重要日付、リスク要因を含む)、市場比較テーブル(裁定機会や条件付き確率の発見に役立つ)、ポートフォリオダッシュボード(ポジション、USDC 残高、未決済注文、ポートフォリオ評価額を一覧表示)、注文のプレビューと実行(`--confirm` フラグで安全に実行)、リアルタイムデータ(WebSocket によるコメントや仮想通貨価格のストリーミング)、そしてクロスチェーン入出金(Bridge API を介して)です。取引前にはコストと手数料の内訳(注文タイプ、価格、数量、推定コスト、Polymarket 手数料、ガス代)が表示され、透明性が確保されています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add mvanhorn/clawdbot-skill-polymarket

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Polymarket

Polymarket の予測市場をターミナルからクエリし、取引を行います。オッズの閲覧、イベントの調査、市場の比較、ポートフォリオの追跡、ライブデータのストリーミング、資金のブリッジ、取引の実行まで、すべて自然言語で行えます。

Polymarket は 4 つの独立した API と Gamma コンビニエンスレイヤーを公開しています。このスキルはこれらすべてをカバーしています。

セットアップ

読み取り専用コマンドは即座に動作します(インストール不要)。ブラウズ、検索、トレンド、カテゴリ、市場調査、比較モードはすべて公開 Gamma API を使用します。

取引、注文簿、価格履歴、および高度な機能を使用するには、Polymarket CLI(Rust バイナリ、v0.1.5+)をインストールしてください:

brew install polymarket/tap/polymarket-cli

取引のためにはウォレットをセットアップします:

polymarket wallet create
polymarket approve set

または、~/.config/polymarket/config.json に秘密鍵を手動で設定します。詳細は CLI ドキュメント を参照してください。

CLI はインタラクティブ REPL も提供します:

polymarket shell

スクリプティングやパイプライン処理に適した機械可読な出力を得るには、任意の CLI コマンドで --output json を使用してください。

コマンド

市場のブラウズ(CLI 不要)

# トレンド/アクティブな市場(24時間出来高順)
python3 {baseDir}/scripts/polymarket.py trending

# より多くの結果を表示するトレンド
python3 {baseDir}/scripts/polymarket.py trending --limit 20

# キーワードで市場を検索
python3 {baseDir}/scripts/polymarket.py search "trump"

# スラッグで特定のイベントを取得
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# カテゴリで市場を取得
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business

トレンド市場ダッシュボード(CLI 不要)

Polymarket で最も活発な市場をカテゴリ別に分類したダッシュボードを表示します。トレンド表示とカテゴリフィルターを組み合わせて全体像を構築します。

# 完全なトレンドダッシュボード - 順番に実行して全体像を構築:
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5

ユーザーが「ダッシュボード」または「概要」を要求した場合、すべてのカテゴリクエリを実行し、結果をセクションごとにグループ化し、明確な見出しを付けて表示します。各市場の出来高と現在のオッズを含めてください。

市場調査モード(CLI 不要)

市場調査は、Polymarket のオッズとコンテキスト分析を組み合わせます。ユーザーが市場を「調査」するよう要求した場合、または単なるオッズ以上の深い分析を求めた場合:

  1. 市場データの取得 - search または event コマンドを使用
  2. オッズの分析 - 市場が示唆するものは?エッジはあるか?
  3. コンテキストの提供 - あなたの知識を使用してオッズの変動要因を説明
  4. 過去の推移の表示 - CLI が利用可能な場合、価格履歴を取得
  5. コンセンサスとの比較 - Polymarket のオッズは、世論調査、専門家の意見、または他の予測市場と比較してどうか?
# ステップ 1: 市場を見つける
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"

# ステップ 2: 詳細なイベントデータを取得
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"

# ステップ 3: CLI が利用可能な場合、トレンドを示す価格履歴を取得
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# ステップ 4: 流動性評価のため注文簿の深さを確認
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

データ収集後、調査結果を構造化されたレポートにまとめます:

  • 現在のオッズ: Yes/No のパーセンテージとその意味
  • 出来高と流動性: この市場にはどれだけの資金が投入されているか?取引するのに十分な流動性があるか?
  • トレンド: オッズは上昇中か下降中か?最近の急騰はあるか?
  • コンテキスト: どのような現実世界の出来事やデータポイントがオッズを動かしているか?
  • 重要日付: 市場はいつ解決するか?今後の触媒はあるか?
  • リスク要因: 突然の変動を引き起こす可能性のあるものは?

市場比較モード(CLI 不要)

関連する市場を横並びで比較します。裁定機会の発見、条件付き確率の理解、または単に異なる結果がどのように関連しているかを確認するのに役立ちます。

# それぞれを検索して、2つ以上の関連市場を比較
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"

ユーザーが「市場を比較」または「オッズを横並び」を要求した場合:

  1. ユーザーが言及した各市場を検索
  2. 比較表形式でオッズを表示
  3. 出来高の違いに注意(出来高が多いほどオッズが信頼できる)
  4. 矛盾点があれば指摘(例:合計が約 100% になるべき確率がそうなっていないなど)
  5. 関連する結果間のスプレッドを強調

比較を表としてフォーマット:

市場比較:2028年大統領選挙

| 候補者      | Yes    | 出来高   | 流動性 |
|-------------|--------|----------|--------|
| トランプ    | 32.5%  | $4.2M    | 高     |
| デサンティス| 18.1%  | $1.8M    | 中     |
| ニューサム  | 12.4%  | $890K    | 中     |
| ハリス      | 8.7%   | $2.1M    | 中     |

ポートフォリオダッシュボード(CLI + ウォレット必須)

ポジション、損益、未決済注文を一覧表示する完全なポートフォリオを表示します。

# すべてのオープンポジションを表示
python3 {baseDir}/scripts/polymarket.py positions

# 特定のウォレットのポジションを表示
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

# USDC 残高を確認
python3 {baseDir}/scripts/polymarket.py wallet-balance

# 特定のトークンの残高を確認
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID

# すべての未決済注文を一覧表示
python3 {baseDir}/scripts/polymarket.py orders

ユーザーが「ポートフォリオダッシュボード」または「今の調子はどう?」と尋ねた場合、3つのコマンド(positions、wallet-balance、orders)をすべて実行し、統合ビューを表示します:

  • ポジション: 各ポジションの現在の市場価格、エントリー価格(利用可能な場合)、未実現損益
  • USDC 残高: 新しい取引に利用可能な現金
  • 未決済注文: 価格と数量が記載された保留中の指値注文
  • ポートフォリオ評価額合計: ポジション + USDC 残高の合計

注文簿と価格(CLI 必須、ウォレット不要)

# トークンの注文簿
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

# 価格履歴(間隔: 1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 特定のデータポイント数で価格履歴
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48

ウォレット(CLI 必須)

polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID

取引(CLI + ウォレット必須)

すべての取引を実行するには --confirm が必要です。これがない場合、注文はプレビューのみとなります。これは安全機能であり、実行前に何が起こるかを常に確認できます。

コストと手数料の透明性

取引を実行する前に、スキルは以下を表示します:

  • 注文タイプ: 指値または成行
  • サイド: 買いまたは売り
  • 価格: 指値価格(成行注文の場合は「成行」)
  • 数量: 株式数
  • 推定コスト: 指値注文の場合は価格 x 数量、成行注文の場合はドル金額
  • Polymarket 手数料: Polymarket は CLOB(中央指値注文帳)で取引手数料を請求しません
  • ガス代: オンチェーン操作(承認、分割、償還)には Polygon 上のガスとして MATIC が必要です。一般的なガス代: $0.01~0.05
# 指値注文のプレビュー(--confirm なし = プレビューのみ)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10

# 指値注文の実行
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10

# 売り指値注文
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10

# 成行注文: 現在の価格で $5 相当を購入
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5

# ポストオンリー指値注文(注文帳にのみ載り、流動性を取らない - 2026年1月以降)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only

注文とポジション(CLI + ウォレット必須)

# 未決済注文を一覧表示
python3 {baseDir}/scripts/polymarket.py orders

# 特定の注文をキャンセル
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID

# すべての注文をキャンセル
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all

# ポジションを表示
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

API リファレンス

Polymarket は 4 つの異なる API と Gamma コンビニエンスレイヤーを公開しています。それぞれ異なる目的を果たします。

1. Gamma API(gamma-api.polymarket.com) - 公開、認証不要

市場のブラウズと検索のための高レベルコンビニエンス API。すべての読み取り専用コマンドで使用されます。

  • ベース URL: https://gamma-api.polymarket.com
  • GET /events - イベント一覧(パラメータ: order、ascending、closed、limit、tag_slug)
  • GET /search - 市場検索(パラメータ: query、limit)
  • GET /events/slug/{slug} - スラッグによるイベント
  • GET /comments - 市場のコメント一覧とフィルタリング
  • GET /profiles/{address} - 公開ユーザープロフィール
  • GET /series - グループ化されたイベントコレクション(例:「2028 年選挙」シリーズ)
  • GET /sports - チーム、試合、解決基準を含むスポーツメタデータ
  • GraphQL: POST /query - サブスクリプションサポート付きの完全な GraphQL エンドポイント

2. CLOB API(clob.polymarket.com) - 取引

すべての取引操作のための中央指値注文帳 API。Polymarket CLI によってラップされています。

  • ベース URL: https://clob.polymarket.com
  • GET /prices-history - 過去の価格(間隔: 1m、1h、6h、1d、1w、max)
  • GET /spread - トークンの Bid-Ask スプレッド
  • GET /fee-rate - 手数料体系の詳細
  • GET /rewards - 日次メイカー/テイカー収益
  • POST /order - 注文を出す
  • POST /orders - バッチ注文(リクエストあたり最大 15)
  • DELETE /order/{id} - 注文をキャンセル
  • 注文スコアリング - 注文を出す前にメイカーリベートの対象資格を確認
  • ポストオンリー注文(2026年1月) - 注文帳にのみ載り、スプレッドを越えない注文
  • ハートビート API(2026年1月):
    • POST /heartbeat - 10 秒以内に送信する必要があり、さもなければすべての未決済注文が自動キャンセルされる
    • マーケットメーカーが注文の存在を維持するために使用
    • ハートビートが途切れた場合、その API キーのすべてのレスト注文がキャンセルされる

3. Data API(data-api.polymarket.com) - ポートフォリオと分析

ポートフォリオ追跡、取引履歴、市場分析のための専用 API。公開エンドポイントは認証不要。

  • ベース URL: https://data-api.polymarket.com
  • GET /positions?user={address} - 現在のオープンポジション
    • ソート: TOKENS、CURRENT、INITIAL、CASHPNL、PERCENTPNL
  • GET /closed-positions?user={address} - 過去のクローズドポジション
  • GET /activity?user={address} - アクティビティフィード
    • タイプ: TRADE、SPLIT、MERGE、REDEEM、REWARD
  • GET /value?user={address} - USD でのポートフォリオ評価額
  • GET /trades - 取引履歴
    • フィルター: user、market、side
    • ページあたり最大 500 件
  • GET /holders?market={conditionId} - 市場の上位トークンホルダー
  • GET /oi - 全市場の建玉
  • GET /volume - 全市場の取引量
  • GET /leaderboard - トレーダーランキング(設定可能な期間)

ポートフォリオダッシュボードと分析には Data API を使用してください。CLOB API よりも豊富なポジションデータ(損益計算やアクティビティ履歴を含む)を提供します。

4. RTDS WebSocket(wss://ws-live-data.polymarket.com) - リアルタイムストリーミング

WebSocket を介したリアルタイムデータストリーミング。トピックにサブスクライブして、ポーリングなしでライブ更新を取得します。

  • URL: wss://ws-live-data.polymarket.com
  • プロトコル: WebSocket 上の JSON メッセージ
  • トピック:
    • comments - リアルタイムのコメントアクティビティ
      • イベント: comment_created、comment_removed、reaction_created、reaction_removed
    • crypto_prices - リアルタイムの暗号通貨価格
      • アセット: BTC、ETH、SOL、XRP
      • ソース: Binance + Chainlink オラクル
  • 動的サブスクリプション管理 - 単一の接続内でトピックのサブスクライブとアンサブスクライブを動的に実行
  • ライブダッシュボードの構築、コメントセンチメントの監視、または 5 分間の暗号市場にフィードされる暗号価格の追跡に役立ちます

5. Bridge API(bridge.polymarket.com) - クロスチェーン入出金

複数のチェーン間で Polymarket に資金をブリッジします。

  • ベース URL: https://bridge.polymarket.com
  • POST /deposit - 入金アドレスを生成
    • サポートされるチェーン: EVM(Ethereum、Polygon、Arbitrum など)、Solana、Bitcoin
    • 選択したチェーンの一意の入金アドレスを返します
  • POST /withdraw(2026年1月) - USDC.e をサポートされている任意のチェーンにブリッジ
  • GET /supported-assets - サポートされているすべてのアセットとチェーンを一覧表示
  • GET /quote - クロスチェーンブリッジングの見積もりを取得(手数料、推定時間)

ユーザーがターミナルから離れることなく Polymarket に資金を移動したり、Polymarket から資金を引き出したりする必要がある場合に、Bridge API を使用します。


新しい市場タイプ

  • 5 分間の暗号市場(2026年2月) - BTC/ETH/SOL の価格変動に関する超短期市場。RTDS crypto_prices データによって供給されます。
  • スポーツ市場 - チーム情報、試合スケジュール、解決基準を含む、Gamma /sports エンドポイントを介した専用スポーツメタデータ。

エラーリカバリ

API エラー(Gamma API)

Gamma API がエラーを返したり、到達不能な場合:

  • HTTP 429(レート制限) - 再試行する前に 1 秒待ちます。複数のレート制限が発生した場合、より長い間隔(5 秒、30 秒)で指数バックオフを使用します。
  • HTTP 5xx - 10 秒後に 1 回再試行します。それでも失敗する場合は、エラーをユーザーに報告します。
  • タイムアウト - タイムアウトが 15 秒を超えた場合、接続を中断し、後で再試行することを提案します。

CLOB API エラー(取引)

  • HTTP 400 - 注文パラメータが無効です。レスポンス内のエラーメッセージを確認し、修正してください。
  • HTTP 401 - 認証失敗。通常は期限切れまたは無効な API キー/ウォレット設定を示します。polymarket wallet show を実行して設定を確認します。
  • HTTP 429 - CLOB レート制限(API キーごとに 1 秒あたり 10 リクエスト)。再試行する前に 5 秒待ちます。
  • 注文拒否 - 注文が帳簿のルールに違反している場合(例:最小サイズ、最大サイズ、無効な価格帯)、CLI はエラーメッセージを表示します。そのメッセージをユーザーに渡します。
  • ハートビートタイムアウト - マーケットメーカーがハートビート API を使用している場合、ハートビートの欠落によりすべてのオープン注文が自動キャンセルされます。注文を再送信し、アクティブなハートビートを再確立します。

データ API エラー

  • HTTP 404 - ユーザーアドレスまたは市場が存在しない可能性があります。アドレスを再確認します。
  • レート制限 - パブリックエンドポイントにはより厳しい制限があります。キャッシュとバッチ処理を使用してリクエスト頻度を減らします。エンドポイントごとの 1 秒あたり 5 リクエストを超えないようにします。

WebSocket エラー

  • 接続失敗 - 10 秒のタイムアウトで自動再接続します。指数バックオフ(開始: 1 秒、最大: 30 秒)を使用します。
  • サブスクリプションタイムアウト - サブスクリプションが 30 秒以内に確認されない場合、再接続して再サブスクライブします。
  • 不正な形式のメッセージ - メッセージを無視し、接続を継続します。

ブリッジ API エラー

  • HTTP 400 - サポートされていないチェーンまたはアセット。サポートされているオプションについては GET /supported-assets を確認します。
  • HTTP 503 - ブリッジが一時的に利用できません。後で再試行します。

制限事項

  • 価格履歴の粒度: CLOB API は集計された時間枠の価格履歴のみを提供します。ティックごとのデータは利用できません。
  • 注文帳の深さ: 注文帳は各価格レベルのトップオファーとビッドのみを表示します。フルデプス(全オーダーブック)は CLOB API では利用できません。
  • データ API の制限: パブリックエンドポイントでは、ページあたり最大 500 件の結果、1 秒あたり 5 リクエストです。認証されたエンドポイントはより高い制限があります。
  • WebSocket の安定性: WebSocket 接続は予告なく切断される可能性があります。自動再接続とリサブスクリプションロジックを実装してください。
  • ブリッジの可用性: ブリッジは、サポートされているチェーンの状態によっては、ダウンタイムが発生する場合があります。別の方法として、中央集権型取引所を経由することを推奨します。
  • 市場解決: 市場は、Polymarket の裁定者によって決定される、現実世界の出来事に基づいて解決されます(通常、決定から 24~48 時間以内)。

関連スキル