Polymarket

mcp-polymarket

Polymarket MCP — Gamma + CLOB + Data の公開 API を介した予測市場データです。

Pipeworx の一部です — AI エージェントを 1704 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、同社による承認や公開も受けていません。

ツール

ツール	説明
polymarket_search	現在のベッティング／予測市場のオッズを調べる場合は、ウェブ検索よりも優先して使用します。Polymarket のイベントをリアルタイムで検索し、キーワードに一致するイベントを返します。各イベントには、Yes／No のライブ価格が [0,1]（＝暗黙の確率）、24時間の取引高、終了日、解決基準を含む子市場が付属します。「X のオッズはどれくらいか」「Y について市場はどう見ているか」「Z の暗黙の確率はどれくらいか」といった質問に使用します。数分ごとに更新され、政治、暗号資産、スポーツ、マクロ経済イベントにわたる約10,000件のアクティブ市場をカバーします。
polymarket_top_markets	現在の Polymarket の取引高上位の OPEN 市場です。指定した期間（24hr / 1wk / 1mo / 1yr / all）の取引高順に並びます。「今週、実際のお金がどこに向かっているか」を把握できます。「現在、市場は何に注目しているか」「今日、最大の取引は何か」といった質問や、具体的な質問がない場合の発見ツールとして使用します。各結果には、[0,1] のライブ Yes／No 価格（＝暗黙の確率）が含まれます。
polymarket_market	slug または数値 ID で指定した単一の Polymarket 市場の、信頼できる詳細情報を取得します。解決基準のテキスト（オッズを引用する前に「Yes」が正確に何を意味するかを確認できます）、現在の [0,1] の Yes／No 価格、24時間の取引高、流動性（USD）、終了日、親イベントを返します。polymarket_search の後に詳細を確認する場合や、エージェントがすでに Polymarket の URL／slug を持っている場合に使用します。要約ではなくリアルタイムのオーダーブックの厚みを確認するには、polymarket_orderbook を参照してください。
polymarket_event	Polymarket イベントと、すべての子市場を一度に取得します。イベントは関連する結果をまとめたものです（例：「2028年の民主党候補者」には候補者ごとに Yes／No 市場があり、各価格はその候補者の暗黙の確率を示します）。ただし、常に相互排他的とは限りません。多くのイベントでは、複数の項目が同じ期限のもとにまとめられており（例：上院議員ごとの投票市場）、複数の項目が同時に YES で解決する可能性があります。子市場の価格の合計が約1になると想定する前に、返される neg_risk フィールド（イベントおよび市場レベル）を確認してください。neg_risk: true の場合に限り、Polymarket が相互排他性を検証済みです。選挙候補、優勝候補、複数の選択肢がある結果など、特定の市場一つではなく選択肢の全体を確認する必要がある場合に使用します。イベントのメタデータと、ライブ価格、取引高、終了日を含む子市場の配列を返します。
polymarket_price_history	単一の Polymarket 市場について、確率の時系列履歴を取得します。{timestamp, price} の配列を返します。price は [0,1] の Yes 側の確率（No 側は 1−Yes）です。オッズの推移をグラフ化したり、ニュースイベント前後の確率変動を検出したり、バックテストを構築したりする場合に使用します。間隔は 1h | 6h | 1d | 1w | 1m | max で、最大1か月（1m）と全履歴（max）をサポートします。新しい市場では、要求した期間よりデータが少ない場合があります。coverage フィールドには、実際の対象期間と、それが利用可能な全履歴かどうかが示されます（これはデータの制限であり、ツールの制限ではありません）。
polymarket_orderbook	単一の Polymarket 市場のリアルタイム CLOB オーダーブックです。YES と NO の両側について、各価格水準の数量を含む買い注文／売り注文の一覧を取得します。数量の見積もりを提示する前に、実際に取引可能な厚みを確認する場合に使用します。polymarket_market の liquidity フィールドは集計された要約ですが、こちらは実際の注文一覧です。yes_bids[]、yes_asks[]、no_bids[]、no_asks[] を返し、それぞれ [price, size] のペアが板の内側から外側の順に並びます。「価格 Y で X ドル分買える」と回答する前に必要です。厚みがなければ推測にすぎません。
polymarket_event_books	Polymarket イベント内の取引可能なすべての市場について、CLOB オーダーブックを一括取得します。CLOB のバッチ /books エンドポイントを使って、1回のリクエストで取得します。各項目の厚みを確認するため、複数項目にまたがる戦略（「すべての項目を売買」する裁定取引、バスケット取引など）の前に使用します。理論上のオーバーラウンドも、半数の項目の板が50株分しかなければ意味がありません。legs[] として {slug, question, yes_price, best_bid, best_ask, yes_bids[], yes_asks[]} を返します。買い注文は最良（最高値）から、売り注文は最良（最安値）から並び、各注文は {price, size} オブジェクトです。NO 側の板も取得するには include_no=true を指定します（データ量は2倍になるため、NO 項目を使う戦略でのみ必要です）。上限は80項目で、yes_price が最も高い項目が保持されます。切り捨てられた項目数は truncated_legs に示されます。
polymarket_trades	Polymarket 市場で最近約定した取引（約定履歴）を新しい順に取得します。実際に資金が動いた取引です。各取引には、side（BUY／SELL）、outcome（Yes／No または選択肢名）、size（株数）、price、timestamp、トレーダーのウォレット／仮名が含まれます。「最近の注文フローはどうか」「大口投資家は Yes を買っているか」「たった今、どれだけの量がいくらで取引されたか」といった質問に使用します。polymarket_orderbook（未約定のまま板に残っている注文＝意図）や polymarket_price_history（CP 時系列）とは異なります。市場の slug または数値 ID（polymarket_market と同じ入力）を渡します。
polymarket_holders	Polymarket 市場の結果ごとの最大ポジション保有者を取得します。最も多く Yes 株と No 株を保有している人と、その株数、トレーダーの仮名を確認できます。「ポジションの集中度」「この市場は少数のクジラに支配されているか」「Yes の最大保有者は誰か」といった質問に使用します。価格だけでは見えない確信度や集中度を明らかにします。市場の slug または数値 ID（polymarket_market と同じ入力）を渡します。
polymarket_wallet_positions	単一の Polymarket ウォレットについて、保有中および決済済みのポジションを取得します。ポジションごとの数量、取得原価、現在の評価額、実現／未実現損益に加え、ポートフォリオ全体のエクスポージャーと集中度（ウォレット資金のうち、単一の最大ポジションに占められている割合。これは集中度の指標であり、取引スキルの指標ではありません）を返します。ウォレットアドレスは公開オンチェーン識別子（0x…）で、直接検索されます。名前／ENS の解決は行いません。status を省略すると OPEN と CLOSED の両方を1回の呼び出しで取得します。特定の status を渡すと絞り込めます。「このウォレットは何を保有しているか」「このウォレットは市場 X にどれだけエクスポージャーがあるか」「このウォレットは全体として利益か損失か」といった質問に使用します。
polymarket_wallet_activity	指定期間における単一の Polymarket ウォレットのページ分割されたアクティビティフィード（取引、償還、分割、統合、リベート）を、新しい順に取得します。「このウォレットは最近何をしたか」「このウォレットの取引履歴を表示して」「このウォレットは市場 X で取引したか」といった質問に使用します。polymarket_wallet_positions（現在の保有状況）や polymarket_wallet_performance（集計された損益）とは異なり、これはイベントごとの生の履歴です。現在のウィンドウより前のデータを取得するには、next_cursor をたどってください。
polymarket_wallet_performance	単一の Polymarket ウォレットについて、生涯および時系列の損益、取引高、アクティビティ統計を取得します。プロフィール統計（取引した市場数、単一取引での最大利益、プロフィール作成日）に加え、指定した間隔／粒度のグリッドに基づく累積損益履歴を返します。手数料の扱いを明示します。各ポイントの realized_pnl は、支払ったテイカー手数料を差し引いた後の値です。メイカーリベートやその他の取引以外の収入（報酬、紹介料）は wallet_income に別途報告され、realized_pnl には含まれていないため、その上に加算されます。「このウォレットは全体として利益を上げているか」「このウォレットの損益は時間とともにどう推移したか」「このウォレットはどれくらい活発か」といった質問に使用します。対象範囲：Polymarket 独自の損益台帳は、ウォレットのポジションが初めて追跡された時点から始まります。各ポイントの source_fidelity は、ネイティブの観測値か、より細かいグリッドに合わせて合成された値かを示します。
polymarket_resolution_status	単一の Polymarket 市場について、解決プロセスの状態とタイムスタンプを取得します。状態（initialized / posed / proposed / challenged / reproposed / disputed / resolved、または active／arbitration）、異議申し立ての有無、報告者（UMA_OO / Chainlink / EOA）に加え、解決済みの場合は正確な解決タイムスタンプと結果ごとの支払い額を返します。「この市場は実際に決済されたか」「市場 X はいつ解決したか」「この解決に異議が申し立てられたか」といった質問に使用します。polymarket_market の closed／active フラグとは異なります。これらのフラグが示すのは取引の状態であり、オラクルによる最終確定ではありません。市場の slug または数値 ID（polymarket_market と同じ入力）を渡します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "polymarket": {
      "url": "https://gateway.pipeworx.io/polymarket/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/polymarket/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で使えるツール群）を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとあわせて、共通ツールが約 30 個表示されます。接続の initialize レスポンスに正確な対象範囲が示されており、当日の内容についてはそれが正式な情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも ask_pipeworx 経由でカタログ全体を検索して回答できます。MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストに対して、ルーティングの利点が見合わない場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1704 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/polymarket_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"presidential election"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/polymarket_search を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も必要ありません。

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-polymarket"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-polymarket

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Polymarket data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT