Polymarket MCP

🚀 PolyMarket ポリゴン市場予測プラットフォーム

PolyMarketは、ポリゴンネットワークに基づく分散型予測市場プラットフォームです。ユーザーはこのプラットフォーム上で、現実世界のイベントに関連するトークンを作成および取引することができます。ユーザーはイベント結果への信頼度に基づいて賭けを行い、トークン価格の変動を通じて収益を得ることができます。

🚀 クイックスタート

ポリゴンプロトコル (MCP) サーバーの概要

PolyMarket ポリゴンプロトコル（MCP）サーバーは、PolyMarket APIに接続する代理サーバーで、ユーザーに予測市場のデータインターフェースを提供することを目的としています。

✨ 主な機能

概要

このサーバーは以下の機能を提供します。

• リアルタイムデータ：現在の市場の最新価格と取引情報を取得します。
• 詳細情報：特定の市場の基本情報（イベントの説明、時間制限など）を照会します。
• 履歴データ：指定された期間の市場の履歴データを確認し、価格変動の傾向を把握します。

特徴

柔軟性

MCPサーバーは複数のインターフェース呼び出し方法をサポートしており、ユーザーは必要に応じて適切な呼び出し方法を選択できます。

高効率性

API呼び出しプロセスを最適化し、効率的なキャッシュメカニズムを採用することで、データ照会の速度と応答時間を確保しています。

拡張性

システムアーキテクチャは柔軟に設計されており、ビジネスニーズに応じて水平方向に拡張でき、高コンカレンシーのシナリオでのパフォーマンス要件を満たすことができます。

📦 インストール

インストール手順

1. 前提条件

   • Python 3.9以上がインストールされていることを確認してください。
   • httpx ライブラリがインストールされていることを確認し、インストールされていない場合は以下のコマンドでインストールしてください。

     pip install httpx>=0.24.0
     

   • mcp-core と python-dotenv をインストールします。

     pip install mcp-core python-dotenv>=1.0.0
     

2. コード例 MCP代理サーバーを初期化する手順は以下の通りです。

   from mcp_core import MP
   
   # 代理を初期化
   mp = MP()
   
   # PolyMarketネットワークに接続
   await mp.connect()
   
   # 現在のすべての市場情報を取得
   markets = await mp.list_markets()
   

ローカルでの実行ガイド

# MCPプロジェクトリポジトリをクローン
git clone https://github.com/poly_market/mcp.git

# プロジェクトディレクトリに移動
cd mcp

# 依存関係をインストール
pip install -r requirements.txt

# サーバーを起動
python3 server.py

📚 ドキュメント

市場リストの取得

機能説明

現在のPolyMarketプラットフォーム上のすべての利用可能な市場情報を取得します。

入力パラメータ

パラメータは必要ありません。

戻り値

JSON形式のデータを返し、以下のフィールドを含みます。

• id：市場の一意の識別子
• event_name：イベント名
• description：イベントの説明
• start_time：イベントの開始時間（ISO 8601形式）
• end_time：イベントの終了時間（ISO 8601形式）

応答例

[
    {
        "id": "market_1",
        "event_name": "2024年アメリカ大統領選挙結果",
        "description": "2024年アメリカ大統領選挙で誰が勝つかを予測します。",
        "start_time": "2023-01-01T00:00:00Z",
        "end_time": "2024-11-08T23:59:59Z"
    },
    ...
]

市場詳細情報の取得

機能説明

指定された市場の詳細情報を照会します。

入力パラメータ

• market_id：市場の一意の識別子（文字列型）

戻り値

JSON形式のデータを返し、以下のフィールドを含みます。

• id：市場の一意の識別子
• event_name：イベント名
• description：イベントの説明
• start_time：イベントの開始時間（ISO 8601形式）
• end_time：イベントの終了時間（ISO 8601形式）
• outcomes：可能なイベント結果とそれに対応する価格情報

応答例

{
    "id": "market_1",
    "event_name": "2024年アメリカ大統領選挙結果",
    "description": "2024年アメリカ大統領選挙で誰が勝つかを予測します。",
    "start_time": "2023-01-01T00:00:00Z",
    "end_time": "2024-11-08T23:59:59Z",
    "outcomes": [
        {
            "outcome_id": "outcome_1",
            "label": "ジョー・バイデンの勝利",
            "probability": 0.7,
            "price": 0.65
        },
        {
            "outcome_id": "outcome_2",
            "label": "ドナルド・トランプの勝利",
            "probability": 0.3,
            "price": 0.45
        }
    ]
}

市場履歴データの取得

機能説明

指定された期間の市場の履歴データを照会します。

入力パラメータ

• market_id：市場の一意の識別子（文字列型）
• start_time：データの開始時間（ISO 8601形式、オプション、デフォルトは最も古い記録時間）
• end_time：データの終了時間（ISO 8601形式、オプション、デフォルトは現在の時間）

戻り値

JSON形式のデータリストを返し、各項目は以下のフィールドを含みます。

• timestamp：タイムスタンプ
• price：当時の市場価格
• volume：当時の取引量

応答例

[
    {
        "timestamp": "2023-10-01T00:00:00Z",
        "price": 0.65,
        "volume": 1234.56
    },
    ...
]

エラー処理

エラーコード

以下は一般的なエラーコードとその意味です。

エラー応答例

{
    "error": {
        "code": 400,
        "message": "パラメータ market_id が欠落または無効です"
    }
}

ドキュメントの拡張

詳細情報については、公式ドキュメントを参照してください。

貢献ガイド

コミュニティの開発者の皆様からのコードの貢献や提案を歓迎します。詳細情報はGitHubリポジトリをご覧ください。

⚠️ 重要提示

このAPIを使用する前に、PolyMarketのサービス利用規約と使用規範をよく読み、関連する操作が合法的かつ規制に準拠していることを確認してください。