Polymarket relayer expliqué : comment fonctionne le modèle sans gas de Polymarket

Polymarket relayer expliqué : le Relayer est la couche de gas-station qui sponsorise chaque action on-chain utilisateur afin que les traders ne paient jamais de gas. Ce guide accompagne les développeurs et les utilisateurs curieux à travers les responsabilités du Relayer, les SDK destinés aux développeurs, les flux de transaction typiques (déploiement de portefeuille, approvals ERC-20, opérations CTF split/merge/redeem, transferts et placement d'ordres), ainsi que les limites opérationnelles nécessaires pour construire des outils robustes.

Points clés

• Le Relayer est une couche de type gas-station network qui sponsorise les transactions sur Polygon PoS afin que les utilisateurs opèrent sans gas avec pUSD.
• Flux courants couverts par le Relayer : déploiement de Proxy wallet, approvals ERC‑20, CTF split/merge/redeem, transferts et placement d'ordres CLOB.
• Il existe des surfaces API et des SDK à utiliser : le Relayer Client SDK (TypeScript/Python) et les trois API REST publiques pour les lectures de marché et de données.
• Les Builders peuvent router des ordres via Polymarket avec attribution et gagner des builder fees ; des limites par niveau s'appliquent.
• Concevrez toujours pour une exécution non déterministe : disputes de résolution UMA, slippage, fills partiels et délais de règlement restent des risques opérationnels.

Pourquoi le Relayer existe

Polymarket fonctionne sur Polygon PoS (chain ID 137) et utilise pUSD (le wrapped USDC de Polymarket) comme actif de règlement. Le Relayer sponsorise le gas afin que les utilisateurs finaux ne détiennent jamais de POL ni ne paient de gas pour les opérations on-chain. Cela supprime une friction utilisateur et rend le trading natif pour des wallets comme MetaMask, Phantom, Rabby, Bitget, OKX, Coinbase et tout wallet compatible EIP-6963.

Architecture générale

Le Relayer agit comme un Gas Station Network (GSN) — il accepte des intentions signées par l'utilisateur hors chaîne, les encapsule en transactions sponsorisées, puis soumet ces transactions sur Polygon. Du point de vue développeur, vous interagissez avec deux familles d'interfaces :

• Des API publiques en lecture et un WebSocket pour les données de marché et de carnet (Gamma, Data, CLOB, et le Market WS). Voir les URL de base exactes ci‑dessous.
• Le Relayer Client SDK (TypeScript et Python) qui gère le déploiement de portefeuille, les approvals, les opérations CTF et le placement d'ordres via le flux sponsorisé.

Points d'entrée publics importants

• 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 — notez que le trading nécessite une API key + HMAC pour les builders ; les lectures sont publiques
• Market WebSocket (real-time book): wss://ws-subscriptions-clob.polymarket.com/ws/market

L'utilisation exacte des API et les limites de débit sont documentées par Polymarket ; utilisez le endpoint Gamma /markets pour les listings de marchés (limit jusqu'à 1000, utilisez after_cursor pour la pagination).

Flux sponsorisés courants (vue développeur)

1. Déploiement de portefeuille

Polymarket prend en charge Gnosis Safe (pré-déployé) et les Proxy wallets (auto-déployés lors de la première transaction). Le Relayer paie le coût de gas pour le déploiement du proxy lorsque vous effectuez votre première action sponsorisée. Depuis le SDK, cela est en général automatique : le SDK détecte l'absence de wallet et demande au Relayer de soumettre une tx de déploiement signée par l'utilisateur.

2. Approvals ERC-20

Les utilisateurs tradent exclusivement avec pUSD. Le flux d'approval sponsorisé par le Relayer soumet des approvals ERC-20 (et les allowances associées) au nom de l'utilisateur afin qu'il puisse interagir avec les contrats CTF et Exchange sans détenir de POL. Le SDK regroupe et gère habituellement les approvals pour réduire la friction.

3. Opérations CTF : split / merge / redeem

Les parts de résultat sont des tokens ERC-1155 mintés via la Gnosis Conditional Token Framework (CTF). Les opérations CTF typiques — split (minter un set complet à partir de $1.00 de pUSD), merge (burn d'un set pour revenir en pUSD), et redeem (burn des tokens gagnants contre $1.00 après résolution) — sont toutes prises en charge via le Relayer. Ces interactions on-chain sont soumises comme transactions sponsorisées par le Relayer.

4. Transferts et retraits

Les transferts de tokens d'issue et de pUSD, ainsi que toute étape explicite de retrait, sont exécutés via des transactions supportées par le Relayer afin que les utilisateurs puissent déplacer des fonds sans payer de gas. Conservez des signaux UX pour les transactions relayées en attente — elles sont on-chain mais peuvent être observables plus tard via la Data API.

5. Placement d'ordres sur le CLOB

Le placement d'ordres (limit ou market/FAK) est routé via le CLOB. Les Builders qui routent des ordres utilisent des API keys + HMAC pour du trading authentifié avec des en-têtes d'attribution. Le Relayer Client SDK intègre la création d'ordres et, lorsque pertinent, gère la sémantique FAK pour les ordres market. Les maker fees sont à zéro ; les taker fees varient selon la catégorie.

Programme Builder et attribution

Des tiers peuvent router des ordres via le CLOB et gagner des builder fees crédités en basis points. Les niveaux comprennent Unverified (limite quotidienne Relayer 100), Verified (limite quotidienne 10 000 et récompenses USDC hebdomadaires) et Partner (illimité). Les identifiants Builder sont obtenus sur https://polymarket.com/settings et le Relayer Client SDK implémente l'authentification et les en-têtes d'attribution requis pour participer.

Préoccupations pratiques pour les développeurs

• Idempotence et retries : Parce que le Relayer soumet des transactions on-chain pour vous, concevez des flux idempotents et une logique de retry robuste. Le SDK aide mais votre backend doit dédupliquer les intentions signées.
• UX pour l'état en attente : Affichez clairement les états en attente/annulé/confirmé. Les transactions relayées sont de véritables transactions blockchain ; utilisez la Data API et le Market WS pour refléter la finalité.
• Limites de débit : Le endpoint /markets de Gamma est limité (300 req / 10 s pour /markets ; limite combinée /markets + /events 900 req / 10 s). La limite globale d'API est 4000 req / 10 s. Respectez cela dans les tâches de polling ou d'indexation.
• Sécurité : Le Relayer signe et soumet les transactions en utilisant son infrastructure. N'assumez pas une garde de clés privées ; votre application doit néanmoins exiger des signatures utilisateur pour les intentions.
• Restrictions géographiques : Polymarket bloque les ordres par IP. Votre application doit respecter ces restrictions ; ne conseillez pas de solutions VPN.

Tests et développement local

Polymarket fournit des SDK clients en TypeScript et Python. Utilisez le SDK pour simuler les flux sponsorisés pendant le développement. Pour les lectures de marché, utilisez les endpoints publics Gamma, Data et CLOB et le Market WS pour les flux temps réel. Rappelez-vous que le WebSocket émet un PING toutes les 10 secondes et supporte jusqu'à 500 instruments par connexion.

Limites opérationnelles et cas limites

• Changements de tick size : Le tick size se resserre de $0.01 à $0.001 près des prix extrêmes ; le WebSocket émet des événements tick_size_change. Votre logique de correspondance et d'affichage des prix doit gérer cela.
• Disputes UMA et retards de résolution : Le Relayer ne peut pas éliminer le risque d'oracle ou de résolution. Les disputes UMA peuvent suspendre le règlement ; prévoyez une UX pour les redeem retardés.
• Frais et économie : Les makers sont sans frais ; les taker fees varient par catégorie (0%–1.8%). Le Relayer ne modifie pas l'économie des frais du marché.

Comment cela affecte vos outils et bots de trading

Si vous construisez des outils exécutant sur Polymarket, fiez-vous au Relayer Client SDK pour les flux utilisateurs et réservez des processus côté serveur pour la signature, l'idempotence et la gestion des en-têtes d'attribution pour les builders. Utilisez les API publiques pour les données de marché et le Market WS pour des mises à jour carnet à faible latence. Anticipez des issues non déterministes (slippage, fills partiels, retards de résolution) et affichez-les clairement dans votre UI.

Conclusion

Polymarket relayer expliqué : c'est la couche opérationnelle qui rend Polymarket sans gas. Pour les développeurs, il centralise le déploiement de portefeuilles, les approvals, les opérations CTF, les transferts et la soumission d'ordres derrière un SDK et un flux de transactions sponsorisées. Utilisez les API publiques et le Relayer Client SDK pour construire des expériences de trading prévisibles et conviviales tout en respectant les limites de débit et les restrictions géographiques.

Lectures complémentaires

• Guides orientés développeur : /guides/polymarket-clob-explained, /guides/polymarket-gasless-trading
• Référence Arbitrage : /guides/polymarket-arbitrage-complete-guide

Questions fréquemment posées

Qu'est-ce que le Polymarket Relayer sponsorise exactement ?

Le Relayer sponsorise le gas on-chain pour les opérations à l'usage des utilisateurs sur Polygon PoS, incluant le déploiement de Proxy wallet, les approvals ERC‑20 pour pUSD, les opérations CTF split/merge/redeem, les transferts de tokens et le placement d'ordres sur le CLOB. Le Relayer encapsule en pratique des intentions signées par l'utilisateur dans des transactions sponsorisées soumises à Polygon.

Ai-je toujours besoin de pUSD pour trader si le gas est sponsorisé ?

Oui. Polymarket utilise pUSD (le wrapped USDC de Polymarket) comme monnaie de règlement. Le Relayer sponsorise uniquement le gas ; vous avez toujours besoin d'un solde pUSD suffisant et des approvals nécessaires pour interagir avec les marchés.

Les builders peuvent-ils router des ordres via le Relayer et gagner des frais ?

Oui. Le Builder Program permet à des tiers de router des ordres via le CLOB avec des en-têtes d'attribution et de gagner des builder fees en basis points. Les niveaux (Unverified, Verified, Partner) imposent des limites quotidiennes Relayer et différentes récompenses. Les identifiants Builder se gèrent sur https://polymarket.com/settings.

Où obtenir des données de marché et des mises à jour temps réel du carnet ?

Utilisez les API REST publiques et le WebSocket : Gamma (https://gamma-api.polymarket.com) pour les marchés, Data (https://data-api.polymarket.com) pour les positions et trades, CLOB (https://clob.polymarket.com) pour les lectures du carnet, et le Market WS (wss://ws-subscriptions-clob.polymarket.com/ws/market) pour les événements de carnet temps réel.

Quels risques opérationnels subsistent même avec le Relayer ?

Le gas sponsorisé supprime le besoin de détenir du POL, mais d'autres risques subsistent : disputes de résolution UMA qui retardent le règlement, slippage et fills partiels sur le CLOB, changements de structure de frais par Polymarket, risque smart-contract, et restrictions géographiques qui bloquent les ordres par IP.