Kalshi Prediction Markets Plugin for Cursor

Ein Cursor-Marketplace-Plugin, das eine Verbindung zur Kalshi Prediction-Markets-API herstellt und es KI-Agenten ermöglicht, Märkte zu lesen und Orders nur mit Benutzerfreigabe zu platzieren.

Funktionen

• Marktdaten lesen: Märkte durchsuchen, Preise prüfen, Orderbücher anzeigen

• Portfoliomanagement: Kontostand prüfen und Positionen anzeigen

• Orderplatzierung: Orders platzieren und stornieren (nur mit ausdrücklicher Benutzerfreigabe)

• Demo & Produktion: Unterstützt sowohl Demo- als auch Produktionsumgebungen

• Sichere Authentifizierung: Authentifizierung auf Basis von RSA-PSS-Signaturen

Related MCP server: Kalshi MCP Server

Installation

1. API-Schlüssel erstellen

Besuchen Sie https://kalshi.com/account/profile und:

1. Klicken Sie auf „Create New API Key“

2. Speichern Sie Ihre Key ID (KALSHI_ACCESS_KEY)

3. Laden Sie Ihren Private Key herunter und speichern Sie ihn (KALSHI_PRIVATE_KEY) – Sie können ihn nicht erneut abrufen!

Für Tests können Sie auch in der Demo-Umgebung unter https://demo.kalshi.com/account/profile Schlüssel erstellen.

2. Plugin installieren

1. Öffnen Sie Cursor

2. Gehen Sie zu Settings → Plugins → Marketplace

3. Suchen Sie nach „kalshi“

4. Klicken Sie auf „Install“

Oder klonen Sie dieses Repository und installieren Sie es lokal:

git clone https://github.com/evanparrott/kalshi

3. Variablen konfigurieren

Gehen Sie in Cursor zu Settings → Plugins → kalshi und legen Sie Folgendes fest:

• KALSHI_ACCESS_KEY: Ihre API-Key-ID von Kalshi

• KALSHI_PRIVATE_KEY: Ihr privater RSA-Schlüssel (gesamter Inhalt der PEM-Datei)

• KALSHI_BASE_URL (optional):

  • Produktion: https://external-api.kalshi.com (Standard)

  • Demo: https://external-api.demo.kalshi.co

Verfügbare Tools

Nur-Lese-Tools (sicher)

• kalshi_get_balance - Kontostand und Portfoliowert prüfen

• kalshi_list_markets - Verfügbare Prognosemärkte durchsuchen

• kalshi_get_market - Details zu einem bestimmten Markt anzeigen

• kalshi_get_orderbook - Aktuelles Orderbuch mit Preisen anzeigen

• kalshi_get_positions - Ihre aktuellen Positionen anzeigen

• kalshi_list_orders - Ihre aktuellen Orders anzeigen

Schreib-Tools (Benutzerfreigabe erforderlich)

• kalshi_create_order - Eine neue Order platzieren

• kalshi_cancel_order - Eine bestehende Order stornieren

Anwendungsbeispiele

"What prediction markets are available on Kalshi?"

Kontostand prüfen

"What's my Kalshi account balance?"

Marktinformationen abrufen

"Show me details about the market HIGHNY-24JAN01-T60"

Order platzieren (Bestätigung erforderlich)

"Buy 10 YES contracts on HIGHNY-24JAN01-T60 at 56 cents"

Der Agent wird:

1. Ihnen die Marktdetails anzeigen

2. das Orderbuch des Marktes anzeigen

3. um Ihre ausdrückliche Bestätigung bitten

4. erst danach die Order platzieren

Sicherheitsfunktionen

• Skill-Datei: Das Plugin enthält eine Skill-Datei, die Agenten vor dem Handel lesen müssen

• Ausdrückliche Freigabe erforderlich: Orders werden niemals ohne Benutzerbestätigung platziert

• Keine Preisrätsel: Agenten müssen die tatsächlichen Orderbuchpreise verwenden

• Klare Bestätigungen: Alle Handelsparameter werden vor der Ausführung bestätigt

• Demo-Modus: Testen Sie sicher mit Spielgeld in der Demo-Umgebung

Demo vs. Produktion

Demo-Umgebung

• Basis-URL: https://external-api.demo.kalshi.co

• Verwendet Spielgeld für Tests

• Eigenes Konto und eigene API-Schlüssel

• Perfekt zum Testen des Plugins

Produktionsumgebung

• Basis-URL: https://external-api.kalshi.com

• Verwendet echtes Geld

• Standard, wenn KALSHI_BASE_URL nicht gesetzt ist

Immer zuerst mit der Demo testen!

Entwicklung

Voraussetzungen

• Node.js 18 oder höher

• npm

Lokale Entwicklung

# Clone the repository
git clone https://github.com/evanparrott/kalshi
cd kalshi

# Install dependencies
npm install

# Set environment variables
export KALSHI_ACCESS_KEY="your-key-id"
export KALSHI_PRIVATE_KEY="$(cat path/to/your/private-key.pem)"
export KALSHI_BASE_URL="https://external-api.demo.kalshi.co"

# Run the server
npm start

Testen

Der MCP-Server kommuniziert über stdio. Sie können ihn mit dem MCP Inspector testen oder direkt in Cursor integrieren.

Veröffentlichung im Cursor-Marketplace

Dieses Plugin ist dafür ausgelegt, im Cursor-Marketplace eingereicht zu werden:

1. Stellen Sie sicher, dass alle Anforderungen erfüllt sind:

   • Public GitHub Repository

   • Gültige .cursor-plugin/plugin.json

   • Gültiges .cursor-plugin/mcp.json

   • Skill-Datei unter skills/kalshi-trading/SKILL.md

   • Funktionsfähiger MCP-Server

   • Keine Geheimnisse im Repository

2. Reichen Sie es ein unter: https://cursor.com/marketplace/publish

3. Geben Sie Folgendes an:

   • Repository-URL

   • Plugin-Beschreibung

   • Anwendungsbeispiele

   • Besondere Installationshinweise

API-Referenz

Die vollständige Kalshi-API-Dokumentation finden Sie unter:

• Offizielle API-Dokumentation

• Erste Schritte

• API-Referenz

Sicherheitshinweise

• Übergeben Sie Ihre API-Schlüssel oder privaten Schlüssel niemals an die Versionsverwaltung

• Bewahren Sie private Schlüssel sicher auf

• Verwenden Sie zum Testen die Demo-Umgebung

• Private Schlüssel können nicht wiederhergestellt werden – speichern Sie sie sofort nach der Erstellung

• Das Plugin verwendet RSA-PSS-SHA256-Signaturen zur Authentifizierung

Fehlerbehandlung

Fehler „Failed to parse KALSHI_PRIVATE_KEY“

Stellen Sie sicher, dass Ihr privater Schlüssel im PEM-Format vorliegt und den vollständigen Schlüssel mit den Headern enthält:

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

Fehler „Unauthorized“

• Prüfen Sie, ob KALSHI_ACCESS_KEY korrekt ist

• Stellen Sie sicher, dass KALSHI_PRIVATE_KEY und KALSHI_ACCESS_KEY zusammengehören

• Prüfen Sie, ob Sie die richtige Basis-URL verwenden (Demo vs. Produktion)

Fehler „Market not found“

• Prüfen Sie, ob das Tickersymbol korrekt ist

• Prüfen Sie den Marktstatus mit kalshi_get_market

• Märkte können geschlossen oder abgewickelt sein

Lizenz

MIT-Lizenz – siehe Datei LICENSE.

Autor

Evan Parrott

Mitwirken

Beiträge sind willkommen! Reichen Sie dazu gerne einen Pull Request ein.

Haftungsausschluss

Dies ist ein inoffizielles Plugin. Nutzung auf eigene Gefahr. Der Handel an Prognosemärkten ist mit finanziellem Risiko verbunden. Verstehen Sie immer, was Sie handeln, und setzen Sie niemals mehr Geld ein, als Sie sich leisten können zu verlieren.

Links

• Kalshi-Website

• Kalshi-API-Dokumentation

• Cursor Marketplace

• Probleme melden