Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: Der Relayer ist die Gasstation-Schicht, die jede On‑Chain‑Benutzeraktion sponsert, sodass Trader niemals Gas zahlen müssen. Dieser Leitfaden führt Entwickler und interessierte Nutzer durch die Verantwortlichkeiten des Relayers, die entwicklerorientierten SDKs, typische Transaktionsabläufe (Wallet-Deployment, ERC‑20-Approvals, CTF split/merge/redeem, Transfers und Order‑Placement) sowie die betrieblichen Limits, die Sie für robuste Tools berücksichtigen müssen.

Wesentliche Erkenntnisse

• Der Relayer ist eine Gas‑Station‑Network-Schicht, die Polygon PoS‑Transaktionen sponsert, damit Nutzer gaslos mit pUSD handeln können.
• Häufige vom Relayer abgedeckte Abläufe: Proxy‑Wallet‑Deployment, ERC‑20‑Approvals, CTF‑split/merge/redeem, Transfers und CLOB‑Order‑Placement.
• Es gibt API‑Oberflächen und SDKs, die Sie verwenden sollten: das Relayer Client SDK (TypeScript/Python) und die drei öffentlichen REST‑APIs für Markt‑ und Datenauslese.
• Builder können Orders mit Attribution durch Polymarket routen und Builder‑Fees verdienen; es gelten gestaffelte Limits.
• Entwerfen Sie immer für nicht‑deterministische Ausführung: UMA‑Resolution‑Dispute, Slippage, Teilfills und Abwicklungszeiten bleiben betriebliche Risiken.

Warum es den Relayer gibt

Polymarket läuft auf Polygon PoS (chain ID 137) und verwendet pUSD (Polymarket's wrapped USDC) als Settlement‑Asset. Der Relayer sponsert Gas, sodass Endnutzer niemals POL halten oder Gas für On‑Chain‑Operationen zahlen müssen. Das entfernt eine Nutzer‑Reibungsquelle und lässt das Trading für Wallets wie MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase und jede EIP-6963‑kompatible Wallet nativ wirken.

High‑Level‑Architektur

Der Relayer fungiert als Gas Station Network (GSN) — er nimmt off‑chain signierte Nutzerintents entgegen, verpackt sie in gesponserte Transaktionen und übermittelt diese auf Polygon. Aus Entwicklersicht interagieren Sie mit zwei Klassen von Schnittstellen:

• Öffentliche Read‑APIs und ein WebSocket für Markt‑ und Orderbuchdaten (Gamma, Data, CLOB und der Market WS). Siehe die exakten Basis‑URLs weiter unten.
• Das Relayer Client SDK (TypeScript und Python), das Wallet‑Deployment, Approvals, CTF‑Operationen und Order‑Placement mit dem gesponserten Flow übernimmt.

Wichtige öffentliche Endpunkte und Oberflächen

• Gamma API (markets, events, tags): https://gamma-api.polymarket.com
• Data API (positions, trades, holders, open interest): https://data-api.polymarket.com
• CLOB API (order book and trading): https://clob.polymarket.com — beachten Sie, dass Trading für Builder API‑Key + HMAC erfordert; Reads sind öffentlich
• Market WebSocket (real‑time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

Exakte API‑Nutzung und Rate‑Limits sind von Polymarket dokumentiert; verwenden Sie den Gamma /markets Endpunkt für Marktlistings (limit bis zu 1000, benutzen Sie after_cursor für Pagination).

Häufige gesponserte Abläufe (Entwickler‑Ansicht)

1. Wallet‑Deployment

Polymarket unterstützt Gnosis Safe (vorinstalliert) und Proxy‑Wallets (Auto‑Deployment bei der ersten Transaktion). Der Relayer übernimmt die Gas‑Kosten für Proxy‑Deployment, wenn Sie Ihre erste gesponserte Aktion ausführen. Aus dem SDK geschieht dies normalerweise automatisch: Das SDK erkennt fehlende Wallet und fordert den Relayer auf, eine vom Nutzer signierte Deployment‑Tx einzureichen.

2. ERC‑20‑Approvals

Nutzer handeln ausschließlich mit pUSD. Der vom Relayer gesponserte Approval‑Flow reicht ERC‑20‑Approvals (und die zugehörigen Allowances) im Auftrag des Nutzers ein, damit er mit den CTF‑ und Exchange‑Contracts interagieren kann, ohne POL zu halten. Das SDK bündelt und verwaltet Approvals üblicherweise, um Reibung zu reduzieren.

3. CTF‑Operationen: split / merge / redeem

Outcome‑Shares sind ERC‑1155‑Tokens, die über das Gnosis Conditional Token Framework (CTF) gemintet werden. Typische CTF‑Operationen — split (ein komplettes Set aus $1.00 pUSD minten), merge (ein Set zurück zu pUSD verbrennen) und redeem (gewinnende Tokens nach Resolution für $1.00 einlösen) — werden alle über den Relayer unterstützt. Diese On‑Chain‑Interaktionen werden als gesponserte Transaktionen durch den Relayer eingereicht.

4. Transfers und Withdrawals

Transfers von Outcome‑Tokens und pUSD sowie etwaige explizite Withdraw‑Schritte werden über Relayer‑unterstützte Transaktionen ausgeführt, sodass Nutzer Gelder bewegen können, ohne Gas zu zahlen. Zeigen Sie im UX eindeutige Signale für ausstehende relayed Transaktionen — sie sind on‑chain, können aber später über die Data API beobachtbar sein.

5. Order‑Placement auf dem CLOB

Order‑Placement (Limit‑ oder Market/FAK‑Orders) wird über den CLOB geroutet. Builder, die Orders routen, verwenden API‑Keys + HMAC für authentifiziertes Trading mit Attribution‑Headern. Das Relayer Client SDK integriert die Order‑Erstellung und behandelt, wenn angebracht, FAK‑Semantik für Market‑Orders. Maker‑Fees sind null; Taker‑Fees variieren je nach Kategorie.

Builder‑Programm und Attribution

Drittparteien können Orders durch den CLOB routen und Builder‑Fees in Basispunkten verdienen. Die Tiers umfassen Unverified (tägliches Relayer‑Limit 100), Verified (tägliches Limit 10.000 und wöchentliche USDC‑Belohnungen) und Partner (unbegrenzt). Builder‑Credentials werden unter https://polymarket.com/settings verwaltet und das Relayer Client SDK implementiert die für die Teilnahme erforderliche Authentifizierung und Attribution‑Header.

Praktische Entwickler‑Aspekte

• Idempotenz und Retries: Weil der Relayer On‑Chain‑Transaktionen für Sie einreicht, gestalten Sie idempotente Abläufe und robuste Retry‑Logik. Das SDK hilft, aber Ihr Backend sollte signierte Intents de‑dupen.
• UX für Pending‑Zustand: Zeigen Sie klare pending/cancelled/confirmed Zustände. Relayed Transaktionen sind echte Blockchain‑Transaktionen; nutzen Sie die Data API und den Market WS, um Finalität abzubilden.
• Rate‑Limits: Gammas /markets Endpunkt ist rate‑limitiert (300 req / 10 s für /markets; kombiniertes /markets + /events Listing‑Limit 900 req / 10 s). Das gesamte API‑Limit liegt bei 4000 req / 10 s. Respektieren Sie diese Limits in Polling‑ oder Indexing‑Jobs.
• Sicherheit: Der Relayer signiert und reicht Transaktionen über seine Infrastruktur ein. Gehen Sie nicht von Private‑Key‑Custody aus; Ihre App sollte dennoch Nutzersignaturen für Intents verlangen.
• Geo‑Beschränkungen: Polymarket geo‑blockt Orders nach IP. Ihre Anwendung muss diese Beschränkungen respektieren; raten Sie nicht zu VPN‑Workarounds.

Testing und lokale Entwicklung

Polymarket stellt Client‑SDKs in TypeScript und Python bereit. Verwenden Sie das SDK, um gesponserte Flows während der Entwicklung zu mocken. Für Marktdaten verwenden Sie die öffentlichen Endpunkte Gamma, Data und CLOB sowie den Market WS für Echtzeit‑Feeds. Denken Sie daran, dass der WebSocket alle 10 Sekunden ein PING sendet und bis zu 500 Instrumente pro Verbindung unterstützt.

Betriebliche Limits und Edge‑Cases

• Tick‑Size‑Änderungen: Die Tick‑Size verengt sich von $0.01 auf $0.001 bei extremen Preisen; der WebSocket sendet tick_size_change‑Events. Ihre Matching‑ und Preis‑Anzeige‑Logik muss das handhaben.
• UMA‑Dispute und Resolution‑Verzögerungen: Der Relayer kann Orakel‑ oder Resolution‑Risiken nicht eliminieren. UMA‑Dispute können die Abwicklung pausieren; planen Sie UX für verzögerte Redeems.
• Fees und Ökonomie: Maker sind gebührenfrei; Taker‑Fees variieren nach Kategorie (0%–1.8%). Der Relayer ändert die Marktgebührenökonomie nicht.

Wie sich das auf Ihre Trading‑Tools und Bots auswirkt

Wenn Sie Tools bauen, die auf Polymarket ausführen, verlassen Sie sich für Nutzerflüsse auf das Relayer Client SDK und behalten serverseitige Prozesse für Signieren, Idempotenz und das Management von Attribution‑Headern für Builder. Nutzen Sie die öffentlichen APIs für Marktdaten und den Market WS für latenzarme Orderbuch‑Updates. Berücksichtigen Sie nicht‑deterministische Ergebnisse (Slippage, Teilfills, Resolution‑Verzögerungen) und stellen Sie diese klar im UI dar.

Abschluss

Polymarket relayer explained: Es ist die operationelle Schicht, die Polymarket gaslos erscheinen lässt. Für Entwickler zentralisiert er Wallet‑Deployment, Approvals, CTF‑Ops, Transfers und Order‑Submission hinter einem SDK und einem gesponserten Transaktionsflow. Verwenden Sie die öffentlichen APIs und das Relayer Client SDK, um vorhersehbare, nutzerfreundliche Trading‑Erlebnisse zu bauen, und respektieren Sie Rate‑Limits sowie Geo‑Beschränkungen.

Weiterführende Lektüre

• Entwickler‑Guides: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Arbitrage‑Referenz: /guides/polymarket-arbitrage-complete-guide

Frequently asked questions

What exactly does the Polymarket Relayer sponsor?

Der Relayer sponsert On‑Chain‑Gas für nutzerzentrierte Operationen auf Polygon PoS, einschließlich Proxy‑Wallet‑Deployment, ERC‑20‑Approvals für pUSD, CTF split/merge/redeem, Token‑Transfers und Order‑Placement auf dem CLOB. Der Relayer verpackt effektiv vom Nutzer signierte Intents in gesponserte Transaktionen, die an Polygon übermittelt werden.

Do I still need pUSD to trade if gas is sponsored?

Ja. Polymarket verwendet pUSD (Polymarket's wrapped USDC) als Settlement‑Währung. Der Relayer sponsert nur Gas; Sie benötigen weiterhin ausreichend pUSD‑Guthaben und die erforderlichen Approvals, um mit Märkten zu interagieren.

Can builders route orders through the Relayer and earn fees?

Ja. Das Builder‑Programm erlaubt Drittparteien, Orders mit Attribution‑Headern durch den CLOB zu routen und Builder‑Fees in Basispunkten zu verdienen. Tiers (Unverified, Verified, Partner) legen tägliche Relayer‑Limits und unterschiedliche Rewards fest. Builder‑Credentials werden unter https://polymarket.com/settings verwaltet.

Where do I get market data and real‑time book updates?

Verwenden Sie die öffentlichen REST‑APIs und den WebSocket: Gamma (https://gamma-api.polymarket.com) für Märkte, Data (https://data-api.polymarket.com) für Positionen und Trades, CLOB (https://clob.polymarket.com) für Orderbuch‑Reads und den Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) für Echtzeit‑Orderbuch‑Events.

What operational risks remain even with the Relayer?

Gesponsertes Gas beseitigt die Notwendigkeit, POL zu halten, aber andere Risiken bleiben: UMA‑Resolution‑Dispute, die die Abwicklung verzögern können, Slippage und Teilfills auf dem CLOB, mögliche Änderungen der Gebührenstruktur durch Polymarket, Smart‑Contract‑Risiken und Geo‑Beschränkungen, die Orders nach IP blocken.