API · KI-Agenten

Die meisten Polymarket-Bots werden 2026 durch das Prompten eines KI-Coding-Agenten gebaut – Claude Code, Cursor, Copilot. Das ist in Ordnung, wenn du den Agenten auf der aktuellen V2-API und auf einer Sicherheitsleitplanke hältst. Diese Seite zeigt wie: Installiere unsere Regeln + read-only Tooling, damit der generierte Code korrekt ist und im Paper-Modus startet, und folge der Checkliste, bevor irgendetwas echtes Geld berührt.

Gib deinem Agenten zuerst die Regeln. Lege unsere AGENTS.md in dein Repo (Claude Code, Cursor, Copilot und andere lesen sie). Sie pinnt die V2-SDKs, Basis-URLs, pUSD-Contracts, die Fallstricke und eine Paper-Standard-Geldschiene – so hört der Agent auf, toten V1-Code (py-clob-client 0.34 / USDC.e) zu schreiben.

Richte deinen Agenten ein

  • Regeln: Füge AGENTS.md in dein Repo-Root ein (plus einen CLAUDE.md-Symlink / .cursor/rules-Spiegel).
  • Kontext: Richte den Agenten auf unsere llms.txt und die API-Referenz, damit er Antworten in aktuellen Docs erdet, nicht in seiner Trainingsvermutung.
  • Erdungsdaten: Installiere das read-only MCP, damit Token-IDs aus Live-Märkten kommen, nicht aus Halluzinationen.
  • Codegen: Richte deinen Generator für typisierte Clients auf Polymarkets maschinenlesbare Specs – CLOB OpenAPI, Data OpenAPI und die AsyncAPI (WebSocket)-Spec –, damit der Agent gegen das echte Schema baut, nicht gegen eine Vermutung.

Die Safe-Vibe-Coding-Checkliste

Halte jeden KI-generierten Trading-Bot an diese, bevor du ihn live laufen lässt:

  1. Starte read-only – zuerst Marktdaten, keine Orders.
  2. Standardmäßig Paper-Modus; Live-Handel erfordert ein explizites --live-Flag.
  3. Schlüssel nur in Umgebungsvariablen – nie hartkodiert, geloggt oder committed.
  4. Pinne das offizielle V2-SDK + Basis-URLs, damit der Agent keine Endpunkte erfinden kann.
  5. Erde auf die Spec / MCP – vertraue keinem Endpunkt, an den sich der Agent „erinnert“.
  6. Brich bei schlechten Daten ab – platziere nie einen Trade auf einem fehlgeschlagenen oder leeren Fetch.
  7. Menschliche Prüfung vor dem ersten Live-Lauf.
  8. Harte Positions- & Verlustlimits + ein Kill-Switch.
Warum das wichtig ist. Vibe-gecodete Trading-Bots scheitern auf bekannte Weise: Handel auf halluzinierten Preisen, Nutzung toter V1-Muster, Installation halluzinierter Pakete (Slopsquatting) und Hartkodieren von Schlüsseln. Die Regeldatei + das read-only MCP + das Paper-zuerst-Gerüst schließen jedes davon standardmäßig.

Ein guter erster Prompt

Using the Polymarket V2 API (py-clob-client-v2) and the AGENTS.md rules in this repo,
write a PAPER bot that finds the BTC-above-150k market, reads its order book, and would
buy Yes under 0.40. Do NOT place live orders. Keys from env only. Fail closed on bad data.

Der Agent sollte Paper-Modus-Code produzieren, mit echten Token-IDs (aus dem MCP/Live-Daten), Schlüsseln aus der Umgebung und ohne Live-Order-Pfad, es sei denn, du fügst selbst --live hinzu.

Gib deinem Agenten echte Märkte

Halluzinierte Token-IDs sind der Vibe-Coding-Bug Nr. 1. Suche hier einen echten Markt, kopiere seine IDs und übergib sie dem Agenten (oder lass es das MCP erledigen):

Weiter: Die AGENTS.md-Regeln · Welches SDK nutzen · Copy-Paste-Rezepte · CLOB-Referenz · Einen Fehler beheben · Boilerplates.

Keine Finanzberatung. Automatisierter Handel riskiert echtes Geld – teste im Paper-Modus und prüfe vor dem Live-Gang.