Polymarket Builder Program : aperçu pour les développeurs

Le Polymarket Builder Program permet à des opérateurs tiers de router des ordres via le CLOB de Polymarket avec attribution, de gagner des builder fees exprimés en points de base, et d'accéder à des avantages du programme comme des limites de relayer plus élevées et des récompenses. Ce guide explique le fonctionnement du programme, les trois niveaux, le principe du partage des revenus et des notes d'intégration pratiques pour les équipes d'ingénierie utilisant le Polymarket Relayer Client.

Points clés

• Le Builder Program permet à des tiers de router des ordres via le CLOB avec attribution et de gagner des builder fees exprimés en points de base.
• Il existe trois niveaux (Unverified, Verified, Partner) avec des limites de relayer journalières et des récompenses croissantes.
• L'intégration d'un builder se fait via des en-têtes d'attribution et le Polymarket Relayer Client SDK (TypeScript et Python) gère le déploiement de portefeuilles, les approvals, les opérations CTF et la passation d'ordres.
• Les maker fees sur Polymarket sont nulles ; les builder fees sont payés aux builders à l'exécution et exprimés en points de base.
• L'obtention des identifiants et les paramètres de builder se gèrent sur polymarket.com/settings ; les détails de revenus et les taux exacts sont contrôlés par Polymarket et peuvent changer.

Pourquoi le Builder Program existe

Polymarket exploite un Central Limit Order Book (CLOB) et sponsorise le gas via un Relayer. Le Builder Program fournit un moyen formel pour des tiers d'ajouter du flux d'ordres à ce CLOB tout en recevant une attribution et une part des revenus (builder fees). Pour les développeurs qui construisent une logique de routage, des frontends de market-making ou une infrastructure de trading, le programme crée une voie directe et supportée pour envoyer du flux vers l'exchange de Polymarket.

Program tiers and what they mean

H2 : Les trois niveaux

• Unverified
  • Limite de relayer journalière : 100 ordres par jour.
  • Avantages : trading sans gas et attribution uniquement.
• Verified
  • Limite de relayer journalière : 10 000 ordres par jour.
  • Avantages : récompenses hebdomadaires en USDC basées sur le volume en plus des builder fees gagnés en points de base.
• Partner
  • Limite de relayer journalière : illimitée.
  • Avantages : limites de débit maximales et support privilégié ; accès aux paliers de récompenses les plus élevés.

Ceux-ci sont les règles publiées par Polymarket pour les niveaux. Les niveaux affectent les limites de débit du programme, l'éligibilité aux récompenses et le niveau de support ; ils ne modifient pas la mécanique fondamentale d'application des builder fees à l'exécution des ordres.

Comment fonctionnent les builder fees et l'attribution

Les builder fees sont configurées en points de base sur les ordres routés et sont versées au builder lorsque l'ordre s'exécute. L'attribution est implémentée via des en-têtes qui identifient le builder de routage ; le Relayer utilise ces en-têtes pour créditer le builder approprié lors de l'exécution.

Mécaniques importantes à retenir :

• Les frais sont exprimés en points de base et appliqués à l'exécution ; les maker fees sur Polymarket restent nulles.
• Les en-têtes d'attribution sont requis pour qu'une transaction soit créditée à un builder. Le Relayer et le CLOB attendent ces en-têtes dans la requête.
• Les récompenses des builders Verified incluent des paiements hebdomadaires en USDC basés sur le volume en plus des builder fees accumulés ; le niveau Partner bénéficie de récompenses et d'un support augmentés.

Polymarket contrôle les taux de frais exacts et les formules de récompense. Les builders ne doivent pas supposer des taux fixes ; consultez polymarket.com/settings pour les réglages et l'émission des identifiants.

Intégration avec le Polymarket Relayer Client

H2 : Le Polymarket Relayer Client (TypeScript & Python)

Polymarket fournit des SDK officiels Relayer Client en TypeScript et Python pour simplifier l'intégration. Le client prend en charge les tâches courantes pour l'utilisateur final afin que votre intégration puisse se concentrer sur la logique de routage et la stratégie d'ordre.

Ce que le client gère pour vous :

• Déploiement de portefeuilles et gestion Proxy ou Gnosis Safe
• Approvals ERC-20 pour pUSD
• Opérations CTF (split/merge/redeem) pour les tokens d'issue
• Création et annulation d'ordres, y compris les ordres de marché exposés comme FAK
• Signature des requêtes avec les en-têtes d'attribution du builder lorsque demandé

Utiliser le Relayer Client réduit la friction d'ingénierie et garantit que les requêtes sont conformes aux attentes du relayer de Polymarket (limites de débit, en-têtes et sémantique CLOB).

Checklist d'intégration pratique

H2 : Checklist d'implémentation pour les builders

1. Obtenir des identifiants
   • Récupérez vos identifiants de builder et définissez votre niveau sur polymarket.com/settings. Cela contrôle vos limites de relayer et votre éligibilité aux récompenses.
2. Choisir un SDK
   • Utilisez le Relayer Client TypeScript ou Python pour accélérer l'intégration et éviter les mauvaises configurations bas niveau.
3. Ajouter l'attribution
   • Assurez-vous que chaque ordre routé inclut les en-têtes d'attribution requis afin que le Relayer puisse créditer votre compte builder.
4. Gérer les approvals et les portefeuilles
   • Utilisez le client pour gérer les approvals pUSD et le déploiement des portefeuilles ; le Relayer sponsorise le gas, de sorte que les utilisateurs finaux restent sans gas.
5. Surveiller les limites
   • Implémentez des quotas dans votre système pour éviter de dépasser les limites de relayer journalières de votre niveau. Les builders Unverified sont limités à 100/jour, Verified à 10 000/jour, Partner est illimité.
6. Prendre en compte les frais et le règlement
   • Suivez l'accumulation des builder fees en points de base et rapprochez-les avec les récompenses hebdomadaires si vous êtes Verified ou Partner.

Considérations comptables et de partage des revenus

H2 : Comment les paiements circulent

• Les builder fees s'accumulent à l'exécution et sont libellées en points de base du trade.
• Les builders Verified reçoivent des récompenses hebdomadaires en USDC basées sur le volume en plus des builder fees ; le niveau Partner reçoit des récompenses améliorées selon le programme de Polymarket.
• Polymarket gère les paiements effectifs et les formules derrière les récompenses hebdomadaires ; les builders doivent utiliser le tableau de bord sur polymarket.com/settings pour les rapports et les détails de paiement.

Notes opérationnelles et de risque

• Les limites de débit du Relayer sont importantes : appliquez des throttles locaux pour éviter des requêtes rejetées et des comportements inattendus.
• Les ordres routés via le Relayer sont soumis aux règles du CLOB de Polymarket : comportement de tick size, sémantique FAK pour les ordres de marché, et règles maker/taker (les makers paient zéro maker fees).
• Les builders n'éliminent pas les autres risques inhérents au trading sur un marché prédictif : risque de résolution (les disputes UMA peuvent retarder le règlement), slippage et exécutions partielles, et risque smart-contract. Affichez toujours ces risques à vos utilisateurs.

Comment cela affecte votre infrastructure de trading

H2 : Impact pratique sur vos systèmes

Si vous exploitez une couche de routage ou un agrégateur, le Builder Program change deux choses : vous pouvez recevoir un revenu direct pour les ordres que vous routez, et vous devez gérer l'attribution et les limites du relayer. Utilisez le Relayer Client pour les opérations de portefeuille et de token afin d'éviter de réimplémenter la logique CTF et gasless. Concevez votre système pour enregistrer l'attribution par ordre, suivre les frais accumulés en points de base et rapprocher les paiements hebdomadaires provenant de Polymarket.

Résumé de clôture

Le Polymarket Builder Program est une voie orientée développeur pour ajouter du flux d'ordres au CLOB de Polymarket avec attribution et partage des revenus. Pour les builders, les principales tâches opérationnelles sont l'obtention des identifiants, l'intégration des en-têtes d'attribution, l'utilisation du Polymarket Relayer Client (TypeScript ou Python) et le respect des limites de relayer par niveau. Les builder fees sont payés en points de base à l'exécution, et les builders Verified/Partner reçoivent des mécanismes de récompense supplémentaires gérés par Polymarket.

Pour plus de détails techniques sur le CLOB et la sémantique du marché, voir /guides/polymarket-clob-explained et pour comprendre la structure des frais sur Polymarket voir /guides/polymarket-fees-explained.

Foire aux questions

Quels sont les niveaux et limites du Polymarket Builder Program ?

Il y a trois niveaux : Unverified (limite de relayer journalière de 100), Verified (limite de relayer journalière de 10 000 plus récompenses hebdomadaires en USDC et builder fees), et Partner (limite de relayer illimitée et support privilégié). Ces niveaux contrôlent les limites de débit et l'éligibilité aux récompenses.

Comment sont payés les builder fees sur Polymarket ?

Les builder fees sont configurées en points de base et sont payées au builder crédité lorsque l'ordre s'exécute. Les builders Verified reçoivent également des récompenses hebdomadaires en USDC basées sur le volume ; les mécaniques exactes de paiement sont gérées par Polymarket.

Dois-je gérer le gas ou le déploiement des portefeuilles ?

Non. Le Polymarket Relayer sponsorise le gas pour les utilisateurs finaux. Le Relayer Client SDK (TypeScript et Python) gère le déploiement des portefeuilles (Proxy ou Gnosis Safe), les approvals pUSD et les opérations CTF afin que vous puissiez vous concentrer sur la logique de routage.

Comment m'assurer que mes transactions sont créditées sur mon compte builder ?

Incluez les en-têtes d'attribution requis sur les requêtes routées. Le Relayer utilise ces en-têtes pour créditer votre builder. Utilisez le Relayer Client officiel pour garantir que les en-têtes et la signature sont corrects.

Où obtenir mes identifiants et paramètres de builder ?

Les identifiants de builder et les paramètres de niveau sont gérés sur polymarket.com/settings. Ce tableau de bord contrôle l'émission des identifiants, l'affectation des niveaux et le reporting.