Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: il Relayer è lo strato "gas-station" che sponsorizza ogni azione on-chain dell'utente in modo che i trader non paghino mai il gas. Questa guida conduce sviluppatori e utenti curiosi attraverso le responsabilità del Relayer, gli SDK rivolti agli sviluppatori, i flussi di transazione tipici (deploy del wallet, approvazioni ERC-20, operazioni CTF split/merge/redeem, trasferimenti e piazzamento ordini) e i limiti operativi di cui devi tenere conto per costruire strumenti robusti.

Punti chiave

• Il Relayer è uno strato di tipo Gas Station Network che sponsorizza transazioni su Polygon PoS in modo che gli utenti operino senza pagare gas usando pUSD.
• Flussi comuni coperti dal Relayer: deploy del Proxy wallet, approvazioni ERC‑20, CTF split/merge/redeem, trasferimenti e piazzamento ordini sul CLOB.
• Ci sono superfici API e SDK che dovresti usare: il Relayer Client SDK (TypeScript/Python) e le tre API REST pubbliche per letture di mercato e dati.
• I Builder possono instradare ordini tramite Polymarket con header di attribuzione e guadagnare builder fees; si applicano limiti a livelli.
• Progetta sempre per esecuzione non deterministica: dispute di UMA, slippage, fill parziali e tempi di settlement restano rischi operativi.

Perché esiste il Relayer

Polymarket gira su Polygon PoS (chain ID 137) e usa pUSD (il wrapped USDC di Polymarket) come asset di settlement. Il Relayer sponsorizza il gas così che gli utenti finali non tengano POL né paghino gas per le operazioni on-chain. Questo rimuove un punto di frizione per l'utente e rende il trading nativo per wallet come MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase e qualsiasi wallet compatibile EIP-6963.

Architettura ad alto livello

Il Relayer agisce come un Gas Station Network (GSN): accetta intenti firmati dall'utente off-chain, li incapsula in transazioni sponsorizzate e invia quelle transazioni su Polygon. Dal punto di vista dello sviluppatore, interagisci con due classi di interfacce:

• API pubbliche di lettura e un WebSocket per dati di mercato e del book (Gamma, Data, CLOB e il Market WS). Vedi gli URL base esatti qui sotto.
• Il Relayer Client SDK (TypeScript e Python) che gestisce il deploy dei wallet, le approvazioni, le operazioni CTF e il piazzamento ordini tramite il flusso sponsorizzato.

Endpoint pubblici e superfici importanti

• 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 — nota: il trading richiede API key + HMAC per i builder; le letture sono pubbliche
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

L'uso preciso delle API e i rate limit sono documentati da Polymarket; usa l'endpoint Gamma /markets per le liste di mercato (limit fino a 1000, usa after_cursor per la paginazione).

Flussi sponsorizzati comuni (vista sviluppatore)

1. Deploy del wallet

Polymarket supporta Gnosis Safe (pre-deployato) e Proxy wallet (auto-deployati alla prima transazione). Il Relayer paga il costo del gas per il deploy del proxy quando esegui la tua prima azione sponsorizzata. Dallo SDK questo è di solito automatico: lo SDK rileva l'assenza di wallet e chiede al Relayer di inviare una tx di deploy firmata dall'utente.

2. Approvazioni ERC-20

Gli utenti fanno trading esclusivamente con pUSD. Il flusso di approvazione sponsorizzato dal Relayer invia approvazioni ERC-20 (e le allowance associate) per conto dell'utente così che possa interagire con i contratti CTF ed Exchange senza detenere POL. Lo SDK di solito batcha e gestisce le approvazioni per ridurre la frizione.

3. Operazioni CTF: split / merge / redeem

Le quote di outcome sono token ERC-1155 mintati tramite il Gnosis Conditional Token Framework (CTF). Le operazioni tipiche CTF — split (mintare un set completo da $1.00 di pUSD), merge (bruciare un set per tornare a pUSD) e redeem (bruciare i token vincenti per $1.00 dopo la risoluzione) — sono tutte supportate tramite il Relayer. Queste interazioni on-chain sono inviate come transazioni sponsorizzate dal Relayer.

4. Trasferimenti e prelievi

I trasferimenti di token di outcome e di pUSD, così come eventuali passaggi espliciti di prelievo, vengono eseguiti tramite transazioni supportate dal Relayer in modo che gli utenti possano muovere fondi senza pagare gas. Mantieni segnali UX per le transazioni in attesa che sono relayate — sono on-chain ma potrebbero essere osservabili più tardi tramite la Data API.

5. Piazzamento ordini sul CLOB

Il piazzamento ordini (limit o market/FAK) è instradato attraverso il CLOB. I Builder che instradano ordini usano API key + HMAC per il trading autenticato con header di attribuzione. Il Relayer Client SDK integra la creazione degli ordini e, quando appropriato, gestisce la semantica FAK per gli ordini di mercato. Le maker fee sono zero; le taker fee variano per categoria.

Builder program e attribuzione

Terze parti possono instradare ordini attraverso il CLOB e guadagnare builder fees accreditate in basis points. I tier includono Unverified (limite giornaliero del relayer 100), Verified (limite giornaliero 10.000 e ricompense settimanali in USDC) e Partner (illimitato). Le credenziali builder si ottengono su https://polymarket.com/settings e il Relayer Client SDK implementa l'autenticazione e gli header di attribuzione necessari per partecipare.

Preoccupazioni pratiche per sviluppatori

• Idempotenza e retry: Poiché il Relayer invia transazioni on-chain per te, progetta flussi idempotenti e logiche di retry robuste. Lo SDK aiuta ma il tuo backend dovrebbe de-duplicare gli intenti firmati.
• UX per lo stato pending: Mostra stati chiari pending/cancelled/confirmed. Le transazioni relayate sono transazioni reali sulla blockchain; usa la Data API e il Market WS per riflettere la finalità.
• Rate limit: L'endpoint /markets di Gamma è rate-limited (300 req / 10 s per /markets; limite combinato /markets + /events 900 req / 10 s). Il limite complessivo API è 4000 req / 10 s. Rispettali in job di polling o indicizzazione.
• Sicurezza: Il Relayer firma e invia transazioni usando la sua infrastruttura. Non presumere la custodia delle chiavi private; la tua app deve comunque richiedere firme utente per gli intenti.
• Restrizioni geografiche: Polymarket blocca ordini per IP. La tua applicazione deve rispettare queste restrizioni; non suggerire soluzioni VPN.

Testing e sviluppo locale

Polymarket fornisce client SDK in TypeScript e Python. Usa lo SDK per mockare i flussi sponsorizzati durante lo sviluppo. Per le letture di mercato usa gli endpoint pubblici Gamma, Data e CLOB e il Market WS per feed real-time. Ricorda che il WebSocket emette un PING ogni 10 secondi e supporta fino a 500 strumenti per connessione.

Limiti operativi e casi limite

• Cambiamenti di tick size: la tick size si restringe da $0.01 a $0.001 vicino a prezzi estremi; il WebSocket emette eventi tick_size_change. La logica di matching e visualizzazione dei prezzi deve gestire questo.
• Dispute UMA e ritardi di risoluzione: il Relayer non può eliminare il rischio dell'oracolo o della risoluzione. Le dispute UMA possono mettere in pausa il settlement; prevedi UX per redemption ritardate.
• Fee ed economia: le maker sono a zero-fee; le taker fee variano per categoria (0%–1.8%). Il Relayer non cambia l'economia delle fee di mercato.

Come questo influenza i tuoi strumenti di trading e bot

Se costruisci strumenti che eseguono su Polymarket, affidati al Relayer Client SDK per i flussi utente e riserva processi server-side per firma, idempotenza e gestione degli header di attribuzione per i builder. Usa le API pubbliche per i dati di mercato e il Market WS per aggiornamenti low-latency del book. Considera esiti non deterministici (slippage, fill parziali, ritardi di risoluzione) e mostrali chiaramente nella UI.

Chiusura

Polymarket relayer explained: è lo strato operativo che rende Polymarket percepibile come gasless. Per gli sviluppatori centralizza il deploy dei wallet, le approvazioni, le operazioni CTF, i trasferimenti e l'invio degli ordini dietro a uno SDK e a un flusso di transazioni sponsorizzate. Usa le API pubbliche e il Relayer Client SDK per costruire esperienze di trading prevedibili e user-friendly rispettando rate limit e restrizioni geografiche.

Ulteriori letture

• Developer-focused guides: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Arbitrage reference: /guides/polymarket-arbitrage-complete-guide

Frequently asked questions

What exactly does the Polymarket Relayer sponsor?

Il Relayer sponsorizza il gas on-chain per le operazioni rivolte all'utente su Polygon PoS, incluso il deploy del Proxy wallet, le approvazioni ERC‑20 per pUSD, CTF split/merge/redeem, trasferimenti di token e il piazzamento ordini sul CLOB. Il Relayer incapsula efficacemente intenti firmati dall'utente in transazioni sponsorizzate inviate a Polygon.

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

Sì. Polymarket usa pUSD (il wrapped USDC di Polymarket) come valuta di settlement. Il Relayer sponsorizza solo il gas; hai comunque bisogno di saldo pUSD sufficiente e delle approvazioni necessarie per interagire con i mercati.

Can builders route orders through the Relayer and earn fees?

Sì. Il Builder Program permette a terze parti di instradare ordini tramite il CLOB con header di attribuzione e di guadagnare builder fees in basis points. I tier (Unverified, Verified, Partner) impongono limiti giornalieri del relayer e ricompense diverse. Le credenziali builder si gestiscono su https://polymarket.com/settings.

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

Usa le REST API pubbliche e il WebSocket: Gamma (https://gamma-api.polymarket.com) per i mercati, Data (https://data-api.polymarket.com) per posizioni e trade, CLOB (https://clob.polymarket.com) per letture dell'order-book e il Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) per eventi real-time del book.

What operational risks remain even with the Relayer?

Il gas sponsorizzato elimina la necessità di detenere POL, ma altri rischi restano: dispute UMA che ritardano il settlement, slippage e fill parziali sul CLOB, cambiamenti nella struttura delle fee da parte di Polymarket, rischio smart-contract e restrizioni geografiche che bloccano ordini per IP.