Polymarket-Fehlercodes und Behebungen

Dieser Leitfaden erklärt die häufigsten Polymarket-Fehlercodes, die Ihnen in der UI und in den APIs begegnen, warum sie auftreten und konkrete Schritte zu ihrer Behebung. Wenn Sie eine Integration, einen Order-Flow oder eine Wallet-Verbindung debuggen, hilft Ihnen dieser Leitfaden, das Problem schnell einzugrenzen.

Wesentliche Erkenntnisse

• Polymarket-Fehler fallen in einige Kategorien: Geoblocking (403), API-Validierung (422), Rate Limits, CLOB-/Trading-Authentifizierung, Wallet- oder pUSD-Funding und CTF-/CTF-Operation-Probleme.
• Für Gamma-Listing-Calls nutzen Sie Cursor-basierte Paginierung (after_cursor) — offset wird mit HTTP 422 abgelehnt.
• Der CLOB erfordert API-Schlüssel + HMAC für Trading; Lesezugriffe sind öffentlich.
• Viele UI-„order rejected“-Fälle entstehen durch Wallet-Deployment, unzureichendes pUSD, fehlende Approvals, Tick-Size-Änderungen oder FAK-Teilfüllungen — prüfen Sie den Relayer-Fluss und die CLOB-Order-Antwort.

Warum Fehler wichtig sind (kurz)

Fehler in einem Prediction-Market-Flow können Orders blockieren, Teilfüllungen verursachen oder die Abstimmung verzögern. Polymarket verwendet mehrere Oberflächen (Gamma, Data, CLOB und ein Market WebSocket). Zu wissen, welche Oberfläche den Fehler ausgelöst hat, erleichtert die Fehlerbehebung.

H2: Häufige API- und WebSocket-Fehlermuster

Gamma (https://gamma-api.polymarket.com)

• Symptom: HTTP 422 beim Paginieren von Märkten mit offset.
  • Warum: Gamma verwendet Keyset-Paginierung. offset wird abgelehnt.
  • Behebung: Verwenden Sie after_cursor mit dem next_cursor, der vom vorherigen Aufruf zurückgegeben wurde. Beispiel:

curl 'https://gamma-api.polymarket.com/markets?limit=100&after_cursor=eyJpZCI6Ij...' \
  -H 'Accept: application/json'

• Symptom: 429-ähnliches Verhalten (Throttling) oder unvorhersehbare 5xx unter Last.
  • Warum: Gamma erzwingt endpoint-spezifische Rate Limits (z. B. hat /markets ein Limit).
  • Behebung: Beachten Sie die dokumentierten Limits, fahren Sie mit exponentiellem Backoff fort und konsolidieren Sie Anfragen (erhöhen Sie limit auf bis zu 1000, wo sinnvoll).

Data API (https://data-api.polymarket.com)

• Gängige Leseabfragen für Positionen, Trades und Open Interest sind öffentlich; wenn Sie Auth-Fehler sehen, prüfen Sie die exakte Basis-URL und die Header.

CLOB (https://clob.polymarket.com)

• Symptom: Order-Placement wird an den Trading-Endpunkten mit einem Authentifizierungsfehler abgelehnt.
  • Warum: Trading-Endpunkte benötigen einen API-Schlüssel und eine HMAC-Signatur. Lesezugriffe (Orderbuch, Midpoint, Preishistorie) sind öffentlich.
  • Behebung: Erzeugen und signieren Sie Requests gemäß CLOB-Spezifikation; testen Sie zuerst Leseaufrufe, bevor Sie Schreiboperationen versuchen.

Market WebSocket (wss://ws-subscriptions-clob.polymarket.com/ws/market)

• Symptom: Verbindung geschlossen oder keine Echtzeit-Ereignisse.
  • Warum: Der Socket erwartet periodische PINGs alle 10 s; Server können inaktive Verbindungen trennen. Außerdem können Sie maximal 500 Instrumente pro Verbindung abonnieren.
  • Behebung: Senden Sie PINGs wie gefordert und teilen Sie Abonnements auf mehrere Verbindungen auf, wenn Sie mehr als 500 Instrumente benötigen.

H2: Geoblock und HTTP 403 (Polymarket geoblock 403)

• Symptom: HTTP 403 beim Versuch, Orders zu platzieren oder auf Trading-Routen zuzugreifen; die UI zeigt eine Geoblock-Meldung.
  • Warum: Polymarket sperrt Order-Platzierungen aus bestimmten Jurisdiktionen basierend auf der IP. Einige Regionen sind vollständig gesperrt; wenige sind nur für Close-only konfiguriert.
  • Behebung: Bestätigen Sie Ihren IP-Standort. Wenn Sie sich in einer gesperrten Jurisdiktion befinden, befolgen Sie die offiziellen Hinweise von Polymarket zur Berechtigung. Versuchen Sie nicht, die Sperre per VPN zu umgehen — das verstößt gegen die Terms of Service. Wenn Sie glauben, die Sperre sei ein Fehler, kontaktieren Sie den Polymarket-Support über die offizielle Seite und legen Sie Verbindungsdiagnosen sowie IP-Nachweise vor.

H2: Häufige Gründe für „order rejected“ und Behebungen

1. Wallet noch nicht deployed oder Proxy fehlt

• Symptom: Order schlägt während des Relayer-Flows mit einem Deployment- oder Proxy-Fehler fehl.
• Warum: Polymarket unterstützt zwei Wallet-Typen; Nicht-Safe-Nutzer erhalten beim ersten Transaktionsversuch einen Proxy, der deployt wird.
• Behebung: Lassen Sie den Relayer den Wallet-Deployment-Flow abschließen. Wiederholen Sie die Order, nachdem die Transaktion abgeschlossen ist.

2. Unzureichendes pUSD oder Tokens

• Symptom: Order wird wegen unzureichendem Guthaben abgelehnt.
• Warum: Für Trades wird pUSD benötigt.
• Behebung: Laden Sie Ihr Konto mit pUSD auf (siehe die Anleitung von Polymarket). Prüfen Sie den Tokenvertrag und das Guthaben in Ihrer Wallet.

3. ERC-20-Approvals und Relayer-Flow

• Symptom: Orderversuch bleibt wartend wegen ausstehender Approval-Operation.
• Warum: Der Relayer kann Approvals gaslos abwickeln, aber der Wallet-Flow muss abgeschlossen werden.
• Behebung: Bestätigen Sie, dass der Relayer-Request abgeschlossen wurde, und prüfen Sie die Wallet-UI auf ausstehende Bestätigungen.

4. Tick-Size- und Mindestinkrement-Fehler

• Symptom: Order wird abgelehnt oder unerwartet gerundet; kleine Preisunterschiede werden nicht akzeptiert.
• Warum: Polymarket erzwingt eine Tick Size (in der Regel $0.01, die sich in Extremen auf $0.001 verengt).
• Behebung: Runden Sie Preis und Größe auf die aktive Tick Size. Abonnieren Sie tick_size_change über das Market WebSocket, um Änderungen zu erkennen.

5. FAK / Market-Order-Teilfüllungen und Slippage

• Symptom: Market-Orders führen zu Teilfüllungen oder scheinen storniert zu werden.
• Warum: Der CLOB-Helper verwendet FAK (Fill-And-Kill). Wenn nicht vollständig gematcht oder die Slippage-Schutzgrenze greift, wird der Rest storniert.
• Behebung: Prüfen Sie die createMarketOrder-Antwort auf gefüllte Menge und behandeln Sie Teilfüllungen programmgesteuert.

6. Gebühr- oder Kategoriebezogene Ablehnungen

• Symptom: Order schlägt mit einem gebührenbezogenen Fehler fehl.
• Warum: Taker-Gebühren variieren nach Kategorie (aktuell 0%–1.8%); Builder können zusätzliche Basispunkte anwenden.
• Behebung: Bestätigen Sie die Marktkategorie und Ihre Attribution-Header, wenn Sie einen Builder verwenden. Stellen Sie sicher, dass Ihre Kostenkalkulationen die Taker-Gebühren enthalten.

H2: CTF-Operationen und Abwicklungsfehler

• Symptom: split/merge/redeem schlägt fehl oder liefert einen Fehler.
• Warum: CTF ist das ERC-1155-Outcome-Token-Framework; Operationen können fehlschlagen, wenn Sie kein pUSD, keine Tokens haben oder wenn die Oracle-Auflösung angefochten ist.
• Behebung: Prüfen Sie die Salden und ob die UMA-Auflösung abgeschlossen ist. Falls UMA-Dispute die Abwicklung pausieren, warten Sie, bis UMA finalisiert.

H2: Troubleshooting-Checklist (kurzes Runbook)

• Bestimmen Sie, welche Oberfläche den Fehler gemeldet hat (Gamma, Data, CLOB oder WebSocket).
• Reproduzieren Sie die minimal fehlerhafte Anfrage (GET Orderbook oder GET Market), bevor Sie Schreibvorgänge versuchen.
• Prüfen Sie den Wallet-Zustand: Proxy deployed, pUSD-Guthaben, ausstehende Relayer-Transaktionen.
• Validieren Sie die Tick Size und runden Sie Eingaben entsprechend.
• Bei Paginierungsfehlern wechseln Sie zu after_cursor (Gamma).
• Respektieren Sie Rate Limits und fahren Sie bei 429/5xx mit Backoff fort.

Wie sich das auf Ihr Trading oder Ihre Integration auswirkt

Fehler, die Orders blockieren, erhöhen Latenzen und beeinträchtigen die Ausführungsqualität. Implementieren Sie defensive Client-Logik: erkennen Sie Teilfüllungen, zeigen Sie klare Fehlermeldungen für Nutzer an und speichern Sie genug Zustand für sichere Wiederholungen. Für Builder, die Orders über den CLOB routen, stellen Sie sicher, dass Ihre Attribution-Header sowie API-Key/HMAC korrekt sind, um unerwartete Ablehnungen zu vermeiden.

Abschluss

Polymarket-Fehlercodes verweisen meist auf eine kleine Anzahl von Root-Causes: Geoblocking, Paginierung/Rate Limits, Auth für Trading, Wallet/Relayer-Zustand, Tick-Size-Beschränkungen und unzureichende Salden. Wenn Sie einen Fehler sehen, identifizieren Sie die Oberfläche, erfassen Sie die rohe Antwort und folgen Sie der obigen Checkliste. Die öffentlichen Polymarket-APIs und das WebSocket sind die primären Diagnose-Oberflächen; beginnen Sie dort.

Häufig gestellte Fragen

Warum erhalte ich HTTP 422 von Gamma, wenn ich Märkte paginiere?

Gamma verwendet Keyset-Paginierung. Die API lehnt offset mit HTTP 422 ab. Verwenden Sie den after_cursor, der vom vorherigen Aufruf zurückgegeben wurde, und den Parameter limit stattdessen.

Was bedeutet Polymarket geoblock 403 und wie behebe ich das?

Ein 403-Geoblock bedeutet, dass Ihre IP in einer Jurisdiktion liegt, die Polymarket für Order-Platzierungen einschränkt. Bestätigen Sie Ihren IP-Standort und befolgen Sie die offiziellen Hinweise von Polymarket zur Berechtigung. Verwenden Sie keine VPNs, um die Sperre zu umgehen; kontaktieren Sie den Support, wenn Sie einen Fehler vermuten.

Meine Market-Order wurde teilweise gefüllt oder storniert — was ist passiert?

Der CLOB-Helper platziert standardmäßig FAK (Fill-And-Kill)-Orders. Wenn die Liquidität die Order nicht vollständig gematcht hat oder der Slippage-Schutz ausgelöst wurde, wird der Rest storniert. Prüfen Sie die Order-Antwort, um die gefüllte Menge zu ermitteln, und wiederholen Sie konservativ.

Warum werden meine Orders wegen Preisinkrementen abgelehnt?

Polymarket erzwingt eine Tick Size (typischerweise $0.01, die sich in Extremen auf $0.001 verengt). Wenn Ihr Preis oder Ihre Menge ein kleineres Inkrement verwendet, wird die Order abgelehnt oder gerundet. Abonnieren Sie tick_size_change im Market WebSocket, um aktuell zu bleiben.

Brauche ich API-Schlüssel, um Orderbücher oder das Market WebSocket zu lesen?

Nein. CLOB-Lesezugriffe (Orderbuch, Midpoint, Preishistorie) und das Market WebSocket sind öffentlich. Trading-Endpunkte auf dem CLOB benötigen einen API-Schlüssel und HMAC; Gamma- und Data-REST-APIs sind öffentliche Leseendpunkte.