polymarket

Polymarket — 予測市場データ

Polymarket の公開 REST API を使用して、予測市場データを照会します。 すべてのエンドポイントは読み取り専用で、認証は一切必要ありません。

すべてのエンドポイントと curl の使用例については、references/api-endpoints.md を参照してください。

使用する場面

• 予測市場、賭けのオッズ、またはイベントの確率について質問された場合
• 「X が起きる確率はどのくらいですか？」と尋ねられた場合
• Polymarket について具体的に質問された場合
• 市場価格、オーダーブックデータ、または価格履歴を知りたい場合
• 予測市場の動きを監視または追跡したい場合

主な概念

• イベントには、1 つ以上の市場が含まれます（1 対多の関係）。
• 市場は二者択一の結果を扱い、Yes／No の価格は 0.00～1.00 です。
• 価格は確率を表します。価格が 0.65 の場合、市場はその事象が起きる可能性を 65％と見ています。
• outcomePrices フィールド：["0.80", "0.20"] のような JSON 形式の配列です。
• clobTokenIds フィールド：価格やオーダーブックの照会に使用する 2 つのトークン ID［Yes、No］の JSON 形式の配列です。
• conditionId フィールド：価格履歴の照会に使用する 16 進数文字列です。
• 取引量の単位は USDC（米ドル）です。

3 つの公開 API

1. Gamma API（gamma-api.polymarket.com）— 発見、検索、閲覧
2. CLOB API（clob.polymarket.com）— リアルタイム価格、オーダーブック、履歴
3. Data API（data-api.polymarket.com）— 取引、建玉

一般的なワークフロー

ユーザーから予測市場のオッズについて尋ねられた場合：

1. Gamma API の public-search エンドポイントを使用して、クエリを検索します。
2. 応答を解析し、イベントとその中にネストされた市場を抽出します。
3. 市場の質問、パーセンテージで示した現在の価格、取引量を提示します。
4. 詳細を求められた場合は、オーダーブックには clobTokenIds、履歴には conditionId を使用して掘り下げます。

結果の提示

読みやすいように、価格をパーセンテージで表示します。

• outcomePrices ["0.652", "0.348"] は「Yes：65.2％、No：34.8％」と表示します。
• 市場の質問と確率を必ず表示します。
• 入手できる場合は取引量も含めます。

例："Will X happen?" — 65.2% Yes ($1.2M volume)

二重エンコードされたフィールドの解析

Gamma API は、JSON 応答内で outcomePrices、outcomes、clobTokenIds を JSON 文字列として返します（二重エンコード）。Python で処理する場合は、json.loads(market['outcomePrices']) を使って実際の配列を取得します。

レート制限

十分に余裕があり、通常の使用で上限に達する可能性は低いです。

• Gamma：10 秒あたり 4,000 リクエスト（一般）
• CLOB：10 秒あたり 9,000 リクエスト（一般）
• Data：10 秒あたり 1,000 リクエスト（一般）

制限事項

• このスキルは読み取り専用です。取引の注文には対応していません。
• 取引にはウォレットベースの暗号資産認証（EIP-712 署名）が必要です。
• 一部の新しい市場では価格履歴が空の場合があります。
• 取引には地理的制限が適用されますが、読み取り専用データには世界中からアクセスできます。