Polymarket Gamma MCP Server

Polymarket Gamma Markets API を操作するための MCP サーバー - 予測市場、イベント、分析に関するデータを取得します。

🚀 機能

📊 主な機能:

• トレンド市場 - 高取引量の人気市場を取得

• 市場検索 - 質問と説明のテキスト検索

• カテゴリによるフィルタリング - タグによる市場 (Politics、Sports、Crypto)

• 市場詳細 - 特定の市場に関する完全な情報

• イベント - 関連する市場を持つイベントを取得

• API 使用状況 - リクエスト使用量の追跡

🔧 技術的特徴:

• API キー不要 - Gamma API へのパブリックアクセス

• TypeScript - 厳密な型付けとデータ検証

• リトライロジック - ネットワークエラー時の自動再試行

• フォーマット済み出力 - ロシア語でのデータ表示

• 制限の追跡 - API 使用量の監視

Related MCP server: Polymarket MCP Server

📦 インストール

# Клонировать и установить зависимости
npm install

# Собрать проект
npm run build

# Запустить тесты
npm test

🛠️ 利用可能なツール

1. get_trending_markets

高取引量のトレンド市場を取得します。

パラメータ:

• limit (数値、デフォルト: 20) - 市場数

応答例:

{
  "summary": "Найдено 5 трендовых рынков",
  "apiUsage": "4/1000 запросов использовано, 996 осталось",
  "markets": "1. Will Joe Biden get Coronavirus before the election?\n   💰 Объём: $32,257 | 💧 Ликвидность: $0\n   🏷️ Теги: US-current-affairs\n   📊 Цены: Yes: 0.0% | No: 0.0%",
  "rawData": [...]
}

2. get_markets_by_category

カテゴリ/タグによる市場の取得。

パラメータ:

• tags (文字列配列、必須) - フィルタリング用カテゴリ

• limit (数値、デフォルト: 50) - 市場数

例:

{
  "tags": ["Politics", "US Election"],
  "limit": 20
}

3. search_markets

テキストクエリによる市場検索。

パラメータ:

• query (文字列、必須) - 検索クエリ

• limit (数値、デフォルト: 30) - 結果数

4. get_market_details

特定の市場の詳細情報を取得します。

パラメータ:

• marketId (文字列、必須) - 市場 ID

5. get_events

関連する市場を持つイベントを取得します。

パラメータ:

• limit (数値、デフォルト: 20) - イベント数

• active (ブール値、デフォルト: true) - アクティブなイベントのみ

• orderBy (文字列) - ソート: volume、liquidity、endDate、createdAt

6. get_event_details

イベントの詳細情報を取得します。

パラメータ:

• eventId (文字列、必須) - イベント ID

7. get_api_usage

API 使用統計の取得。

🔗 API エンドポイント

サーバーは以下の Gamma API エンドポイントを使用します:

• GET /markets - 市場リスト

• GET /markets/{id} - 市場詳細

• GET /events - イベントリスト

• GET /events/{id} - イベント詳細

ベース URL: https://gamma-api.polymarket.com

📊 データ構造

ProcessedMarket

{
  id: string;
  question: string;
  description?: string;
  outcomes: string[];
  prices: number[];
  volume: number;
  liquidity: number;
  endDate: string;
  tags: string[];
  active: boolean;
  closed: boolean;
  resolved: boolean;
  negRisk: boolean;
  spread?: number;
  slug: string;
  tokens: Array<{
    id: string;
    outcome: string;
    price: number;
    winner?: boolean;
  }>;
}

ProcessedEvent

{
  id: string;
  title: string;
  description?: string;
  slug: string;
  tags: string[];
  startDate?: string;
  endDate?: string;
  active: boolean;
  closed: boolean;
  volume?: number;
  liquidity?: number;
  marketsCount: number;
  topMarkets?: ProcessedMarket[];
}

🧪 テスト

# Основные тесты
npm test

# Отладка API структуры
node test/debug-api.js

⚠️ 制限事項

1. パブリック API - キーなし、ただし合理的な制限あり

2. 読み取り専用 - 注文は不可 (そのためには CLOB API が必要)

3. 簡易検索 - 現時点では全文検索なし

4. 遅延データ - リアルタイムの相場ではない

🔄 Windsurf との統合

mcp_config.json に追加:

{
  "mcpServers": {
    "polymarket-gamma": {
      "command": "node",
      "args": ["C:/Users/pavelk/Desktop/Projects/my_own/Bet/polymarket/mcp-servers/polymarket-gamma-server/dist/index.js"],
      "cwd": "C:/Users/pavelk/Desktop/Projects/my_own/Bet/polymarket/mcp-servers/polymarket-gamma-server"
    }
  }
}

📈 使用例

このサーバーは以下に最適です:

• 市場分析 - トレンドと取引量の調査

• イベント監視 - 新しい市場の追跡

• リサーチ - 分析用データの収集

• 機会のスクリーニング - 興味深い市場の検索

実際の取引には、別の CLOB MCP サーバーを使用してください。

🚀 次のステップ

1. ✅ Gamma API サーバー - 準備完了、テスト済み

2. 🔄 CLOB API サーバー - 取引操作用

3. 🔄 WebSocket サーバー - リアルタイムデータ用

4. 🔄 統合サーバー - すべての機能を統合