Polymarket Gamma MCP Server

MCP-Server für die Arbeit mit Polymarket Gamma Markets API – Abruf von Daten über Prognosemärkte, Ereignisse und Analysen.

🚀 Funktionen

📊 Wichtigste Funktionen:

• Trend-Märkte – Abruf beliebter Märkte mit hohem Volumen

• Marktsuche – Suche nach Text in Fragen und Beschreibungen

• Filterung nach Kategorien – Märkte nach Tags (Politics, Sports, Crypto)

• Marktdetails – vollständige Informationen zu einem bestimmten Markt

• Ereignisse – Abruf von Ereignissen mit zugehörigen Märkten

• API Usage – Verfolgung der Anfragenutzung

🔧 Technische Besonderheiten:

• Ohne API-Schlüssel – öffentlicher Zugriff auf die Gamma API

• TypeScript – strenge Typisierung und Datenvalidierung

• Retry-Logik – automatische Wiederholungen bei Netzwerkfehlern

• Formatierte Ausgabe – übersichtliche Darstellung der Daten auf Deutsch

• Limit-Tracking – Überwachung der API-Nutzung

Related MCP server: Polymarket MCP Server

📦 Installation

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

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

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

🛠️ Verfügbare Tools

1. get_trending_markets

Abruf von Trend-Märkten mit hohem Handelsvolumen.

Parameter:

• limit (Zahl, Standard: 20) – Anzahl der Märkte

Beispielantwort:

{
  "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

Abruf von Märkten nach Kategorien/Tags.

Parameter:

• tags (Zeichenfolgen-Array, erforderlich) – Kategorien für die Filterung

• limit (Zahl, Standard: 50) – Anzahl der Märkte

Beispiel:

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

3. search_markets

Suche nach Märkten über eine Textabfrage.

Parameter:

• query (Zeichenfolge, erforderlich) – Suchanfrage

• limit (Zahl, Standard: 30) – Anzahl der Ergebnisse

4. get_market_details

Abruf detaillierter Informationen zu einem bestimmten Markt.

Parameter:

• marketId (Zeichenfolge, erforderlich) – ID des Marktes

5. get_events

Abruf von Ereignissen mit zugehörigen Märkten.

Parameter:

• limit (Zahl, Standard: 20) – Anzahl der Ereignisse

• active (Boolescher Wert, Standard: true) – nur aktive Ereignisse

• orderBy (Zeichenfolge) – Sortierung: volume, liquidity, endDate, createdAt

6. get_event_details

Abruf detaillierter Informationen zu einem Ereignis.

Parameter:

• eventId (Zeichenfolge, erforderlich) – ID des Ereignisses

7. get_api_usage

Abruf von Statistiken zur API-Nutzung.

🔗 API-Endpunkte

Der Server verwendet die folgenden Gamma-API-Endpunkte:

• GET /markets – Liste der Märkte

• GET /markets/{id} – Marktdetails

• GET /events – Liste der Ereignisse

• GET /events/{id} – Ereignisdetails

Basis-URL: https://gamma-api.polymarket.com

📊 Datenstruktur

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[];
}

🧪 Testen

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

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

⚠️ Einschränkungen

1. Öffentliche API – ohne Schlüssel, aber mit angemessenen Limits

2. Nur Lesen – keine Auftragsplatzierung möglich (dafür wird die CLOB-API benötigt)

3. Vereinfachte Suche – derzeit ohne Volltextsuche

4. Verzögerte Daten – keine Echtzeit-Kurse

🔄 Integration mit Windsurf

Fügen Sie Folgendes in mcp_config.json hinzu:

{
  "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"
    }
  }
}

📈 Verwendung

Dieser Server eignet sich ideal für:

• Marktanalysen – Untersuchung von Trends und Volumina

• Ereignisüberwachung – Verfolgung neuer Märkte

• Forschung – Datenerfassung für Analysen

• Screening von Möglichkeiten – Suche nach interessanten Märkten

Für den realen Handel verwenden Sie einen separaten CLOB MCP Server.

🚀 Nächste Schritte

1. ✅ Gamma API Server – bereit und getestet

2. 🔄 CLOB API Server – für Handelsoperationen

3. 🔄 WebSocket Server – für Echtzeit-Daten

4. 🔄 Unified Server – Bündelung aller Funktionen