Polymarket relayer explained: how Polymarket's gasless model works

Polymarket relayer explained: el Relayer es la capa de estación de gas que patrocina cada acción en cadena del usuario para que los traders nunca paguen gas. Esta guía lleva a desarrolladores y usuarios curiosos a través de las responsabilidades del Relayer, los SDK orientados a desarrolladores, los flujos típicos de transacción (despliegue de wallet, aprobaciones ERC-20, split/merge/redeem de CTF, transferencias y colocación de órdenes) y los límites operativos que necesitas conocer para construir herramientas robustas.

Puntos clave

• El Relayer es una capa de tipo Gas Station Network que patrocina transacciones en Polygon PoS para que los usuarios transaccionen sin gas usando pUSD.
• Flujos comunes cubiertos por el Relayer: despliegue de Proxy wallet, aprobaciones ERC‑20, split/merge/redeem en CTF, transferencias y colocación de órdenes en el CLOB.
• Hay superficies de API y SDKs que deberías usar: el Relayer Client SDK (TypeScript/Python) y las tres REST APIs públicas para lecturas de mercado y datos.
• Los Builders pueden enrutar órdenes a través de Polymarket con atribución y ganar builder fees; se aplican límites por niveles.
• Diseña siempre para ejecución no determinista: disputas de resolución UMA, slippage, fills parciales y tiempos de liquidación siguen siendo riesgos operativos.

Por qué existe el Relayer

Polymarket funciona sobre Polygon PoS (chain ID 137) y utiliza pUSD (el wrapped USDC de Polymarket) como activo de liquidación. El Relayer patrocina el gas para que los usuarios finales no tengan que poseer POL ni pagar gas por operaciones on-chain. Esto elimina una fricción para el usuario y permite que el trading parezca nativo en wallets como MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase y cualquier wallet compatible con EIP-6963.

Arquitectura a alto nivel

El Relayer actúa como una Gas Station Network (GSN): acepta intenciones firmadas por el usuario fuera de cadena, las empaqueta en transacciones patrocinadas y envía esas transacciones a Polygon. Desde el punto de vista del desarrollador, interactúas con dos clases de interfaces:

• APIs públicas de lectura y un WebSocket para datos de mercado y libro (Gamma, Data, CLOB y el Market WS). Consulta las URLs base exactas más abajo.
• El Relayer Client SDK (TypeScript y Python) que gestiona el despliegue de wallets, aprobaciones, operaciones CTF y la colocación de órdenes mediante el flujo patrocinado.

Endpoints y superficies públicas importantes

• 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: el trading requiere API key + HMAC para builders; las lecturas son públicas
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

El uso exacto de las APIs y los límites de tasa están documentados por Polymarket; usa el endpoint Gamma /markets para listados de mercados (limit hasta 1000, usa after_cursor para paginación).

Flujos patrocinados comunes (vista del desarrollador)

1. Despliegue de wallet

Polymarket soporta Gnosis Safe (pre-deployado) y Proxy wallets (auto-desplegado en la primera transacción). El Relayer paga el coste de gas para el despliegue del proxy cuando realizas tu primera acción patrocinada. Desde el SDK esto suele ser automático: el SDK detecta que no hay wallet y solicita al Relayer que envíe una tx de despliegue firmada por el usuario.

2. Aprobaciones ERC-20

Los usuarios comercian exclusivamente con pUSD. El flujo de aprobación patrocinada por el Relayer envía aprobaciones ERC-20 (y los allowances asociados) en nombre del usuario para que pueda interactuar con los contratos CTF y Exchange sin poseer POL. El SDK normalmente agrupa y gestiona aprobaciones para reducir fricción.

3. Operaciones CTF: split / merge / redeem

Los shares de resultado son tokens ERC-1155 mintados mediante el Gnosis Conditional Token Framework (CTF). Las operaciones CTF típicas — split (mintear un set completo desde $1.00 de pUSD), merge (quemar un set y volver a pUSD) y redeem (quemar los tokens ganadores por $1.00 tras la resolución) — son todas compatibles a través del Relayer. Estas interacciones on-chain son enviadas como transacciones patrocinadas por el Relayer.

4. Transferencias y retiros

Las transferencias de tokens de resultado y de pUSD, así como cualquier paso explícito de retiro, se ejecutan mediante transacciones respaldadas por el Relayer para que los usuarios puedan mover fondos sin pagar gas. Mantén señales de UX para transacciones relayed pendientes: son on-chain pero pueden ser observables más tarde vía la Data API.

5. Colocación de órdenes en el CLOB

La colocación de órdenes (limit o market/FAK) se enruta a través del CLOB. Los Builders que enrutan órdenes usan API keys + HMAC para trading autenticado con headers de atribución. El Relayer Client SDK integra la creación de órdenes y, cuando procede, gestiona la semántica FAK para órdenes de mercado. Las maker fees son cero; las taker fees varían según categoría.

Programa Builder y atribución

Terceros pueden enrutar órdenes a través del CLOB y ganar builder fees acreditados en basis points. Los niveles incluyen Unverified (límite diario de relayer 100), Verified (límite diario 10,000 y recompensas semanales en USDC) y Partner (ilimitado). Las credenciales de Builder se obtienen en https://polymarket.com/settings y el Relayer Client SDK implementa la autenticación y los headers de atribución necesarios para participar.

Preocupaciones prácticas para desarrolladores

• Idempotencia y reintentos: Debido a que el Relayer envía transacciones on-chain por ti, diseña flujos idempotentes y lógica robusta de reintentos. El SDK ayuda pero tu backend debe desduplicar signed intents.
• UX para estado pendiente: Muestra estados claros de pendiente/cancelado/confirmado. Las transacciones relayed son transacciones reales en la blockchain; usa la Data API y el Market WS para reflejar la finalización.
• Límites de tasa: El endpoint /markets de Gamma está rate-limited (300 req / 10 s para /markets; límite combinado /markets + /events de 900 req / 10 s). El límite global de la API es 4000 req / 10 s. Respeta esto en trabajos de polling o indexación.
• Seguridad: El Relayer firma y envía transacciones usando su infraestructura. No asumas custodia de claves privadas; tu app debe seguir requiriendo firmas de usuario para las intenciones.
• Restricciones geográficas: Polymarket bloquea órdenes por IP. Tu aplicación debe respetar estas restricciones; no aconsejes soluciones con VPN.

Testing y desarrollo local

Polymarket proporciona SDKs cliente en TypeScript y Python. Usa el SDK para simular flujos patrocinados durante el desarrollo. Para lecturas de mercado, usa los endpoints públicos Gamma, Data y CLOB y el Market WS para feeds en tiempo real. Recuerda que el WebSocket emite un PING cada 10 segundos y soporta hasta 500 instrumentos por conexión.

Límites operativos y casos límite

• Cambios de tick size: El tick size se aprieta de $0.01 a $0.001 cerca de precios extremos; el WebSocket emite eventos tick_size_change. Tu lógica de matching y presentación de precios debe manejar esto.
• Disputas UMA y retrasos en la resolución: El Relayer no puede eliminar el riesgo del oráculo ni de resolución. Las disputas UMA pueden pausar la liquidación; planifica la UX para redenciones demoradas.
• Tarifas y economía: Makers no pagan tarifas; las taker fees varían por categoría (0%–1.8%). El Relayer no altera la economía de tarifas del mercado.

Cómo afecta a tus herramientas y bots de trading

Si construyes herramientas que ejecutan en Polymarket, apóyate en el Relayer Client SDK para los flujos de usuario y reserva procesos server-side para firma, idempotencia y gestión de headers de atribución para builders. Usa las APIs públicas para datos de mercado y el Market WS para actualizaciones de libro de baja latencia. Ten en cuenta resultados no deterministas (slippage, fills parciales, retrasos de resolución) y preséntalos claramente en tu UI.

Cierre

Polymarket relayer explained: es la capa operativa que hace que Polymarket se sienta sin gas. Para desarrolladores centraliza el despliegue de wallets, aprobaciones, operaciones CTF, transferencias y el envío de órdenes tras un SDK y un flujo de transacciones patrocinadas. Usa las APIs públicas y el Relayer Client SDK para construir experiencias de trading previsibles y amigables, respetando límites de tasa y restricciones geográficas.

Lecturas adicionales

• Guías orientadas a desarrolladores: /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Referencia de arbitraje: /guides/polymarket-arbitrage-complete-guide

Frequently asked questions

What exactly does the Polymarket Relayer sponsor?

El Relayer patrocina el gas on-chain para operaciones de cara al usuario en Polygon PoS, incluyendo despliegue de Proxy wallet, aprobaciones ERC‑20 para pUSD, split/merge/redeem en CTF, transferencias de tokens y colocación de órdenes en el CLOB. El Relayer efectivamente envuelve intenciones firmadas por el usuario en transacciones patrocinadas enviadas a Polygon.

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

Sí. Polymarket usa pUSD (el wrapped USDC de Polymarket) como la moneda de liquidación. El Relayer solo patrocina el gas; aún necesitas saldo suficiente en pUSD y las aprobaciones necesarias para interactuar con los mercados.

Can builders route orders through the Relayer and earn fees?

Sí. El Builder Program permite a terceros enrutar órdenes a través del CLOB con headers de atribución y ganar builder fees en basis points. Los niveles (Unverified, Verified, Partner) imponen límites diarios del relayer y diferentes recompensas. Las credenciales de Builder se gestionan en https://polymarket.com/settings.

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

Usa las REST APIs públicas y el WebSocket: Gamma (https://gamma-api.polymarket.com) para mercados, Data (https://data-api.polymarket.com) para posiciones y trades, CLOB (https://clob.polymarket.com) para lecturas del order-book, y el Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) para eventos de libro en tiempo real.

What operational risks remain even with the Relayer?

El gas patrocinado elimina la necesidad de tener POL, pero otros riesgos permanecen: disputas de resolución UMA que retrasan la liquidación, slippage y fills parciales en el CLOB, cambios en la estructura de tarifas por parte de Polymarket, riesgo de smart contracts y restricciones geográficas que bloquean órdenes por IP.