Polymarket Builder Program: Panoramica per sviluppatori

Il Polymarket Builder Program è un meccanismo che permette a operatori terzi di instradare ordini attraverso il CLOB di Polymarket con attribuzione, guadagnare builder fees espresse in basis point e accedere a benefici del programma come limiti di relayer più alti e ricompense. Questa guida spiega il funzionamento del programma, i tre livelli, come funziona in linea di principio la revenue share e note pratiche di integrazione per i team di ingegneria che usano il Polymarket Relayer Client.

Punti chiave

• Il Builder Program permette a terze parti di instradare ordini attraverso il CLOB con attribuzione e guadagnare builder fees espresse in basis point.
• Ci sono tre livelli (Unverified, Verified, Partner) con limiti giornalieri di relayer e ricompense crescenti.
• L'integrazione del builder avviene tramite header di attribuzione e il Polymarket Relayer Client SDK (TypeScript e Python) gestisce il deployment dei wallet, le approvazioni, le operazioni CTF e l'invio degli ordini.
• Le maker fees su Polymarket sono zero; le builder fees vengono pagate ai builder al momento dell'esecuzione e sono espresse in basis point.
• Le credenziali e le impostazioni dei builder sono gestite su polymarket.com/settings; i dettagli sulle revenue e i tassi esatti delle fee sono controllati da Polymarket e possono cambiare.

Perché esiste il Builder Program

Polymarket gestisce un Central Limit Order Book (CLOB) e sponsorizza il gas tramite un Relayer. Il Builder Program offre un modo formale per terze parti di aggiungere flusso di ordini a quel CLOB ricevendo attribuzione e una quota di ricavo (builder fees). Per gli sviluppatori che costruiscono logiche di routing, interfacce di market-making o infrastrutture di trading, il programma crea un percorso diretto e supportato per inviare flussi all'exchange di Polymarket.

Tier del programma e cosa significano

H2: I tre livelli

• Unverified
  • Limite giornaliero del relayer: 100 ordini al giorno.
  • Benefici: trading gasless e sola attribuzione.
• Verified
  • Limite giornaliero del relayer: 10.000 ordini al giorno.
  • Benefici: ricompense settimanali in USDC basate sul volume più builder fees guadagnate in basis point.
• Partner
  • Limite giornaliero del relayer: Illimitato.
  • Benefici: limiti di velocità più alti e supporto elevato; accesso ai livelli di ricompensa più alti.

Queste sono le regole pubblicate da Polymarket per i livelli. I tier influenzano i rate limit del programma, l'idoneità alle ricompense e il livello di supporto; non cambiano la meccanica di base con cui le builder fees vengono applicate all'esecuzione delle operazioni.

Come funzionano le builder fees e l'attribuzione

Le builder fees sono configurate come basis point sugli ordini instradati e vengono pagate al builder quando un ordine viene eseguito. L'attribuzione è implementata tramite header che identificano il builder che ha instradato l'ordine; il Relayer usa quegli header per accreditare il builder appropriato all'esecuzione.

Meccaniche importanti da ricordare:

• Le fee sono espresse in basis point e applicate all'esecuzione; le maker fees su Polymarket restano zero.
• Gli header di attribuzione sono obbligatori perché un trade sia accreditato a un builder. Il Relayer e il CLOB si aspettano quegli header nella richiesta.
• Le ricompense per i builder Verified includono pagamenti settimanali in USDC basati sul volume oltre alle builder fees accumulate; il tier Partner ha ricompense e supporto elevati.

Polymarket controlla i tassi esatti delle fee e le formule delle ricompense. I builder non dovrebbero assumere tassi fissi; consultare polymarket.com/settings per le credenziali correnti e la configurazione del builder.

Integrazione con il Polymarket Relayer Client

H2: Il Polymarket Relayer Client (TypeScript & Python)

Polymarket fornisce SDK ufficiali del Relayer Client in TypeScript e Python per semplificare l'integrazione. Il client gestisce i compiti comuni per gli utenti finali in modo che la tua integrazione possa concentrarsi sulla logica di routing e sulla strategia d'ordine.

Cosa gestisce il client per te:

• Deployment dei wallet e gestione di Proxy o Gnosis Safe
• Approvazioni ERC-20 per pUSD
• Operazioni CTF (split/merge/redeem) per i token di outcome
• Creazione e cancellazione ordini, inclusi gli ordini di mercato esposti come FAK
• Firma delle richieste con gli header di attribuzione del builder quando richiesto

Usare il Relayer Client riduce l'attrito ingegneristico e assicura che le richieste siano conformi alle aspettative del relayer di Polymarket (rate limit, header e semantica del CLOB).

Checklist pratica di integrazione

H2: Checklist di implementazione per i builder

1. Ottieni le credenziali
   • Recupera le tue credenziali da builder e imposta il tuo tier su polymarket.com/settings. Questo controlla i tuoi limiti di relayer e l'idoneità alle ricompense.
2. Scegli un SDK
   • Usa il Relayer Client TypeScript o Python per accelerare l'integrazione ed evitare errate configurazioni a basso livello.
3. Aggiungi l'attribuzione
   • Assicurati che ogni ordine instradato includa gli header di attribuzione richiesti così che il Relayer possa accreditare il tuo account builder.
4. Gestisci approvazioni e wallet
   • Usa il client per gestire le approvazioni pUSD e il deployment dei wallet; il Relayer sponsorizza il gas, quindi gli utenti finali rimangono gasless.
5. Monitora i limiti
   • Implementa quote nel tuo sistema per evitare di superare i limiti giornalieri di relayer per il tuo tier. I builder Unverified sono limitati a 100/giorno, i Verified a 10.000/giorno, Partner è illimitato.
6. Considera fee e settlement
   • Tieni traccia delle accruals delle builder fees in basis point e riconcilia con le ricompense settimanali se sei Verified o Partner.

Considerazioni contabili e sulla revenue share

H2: Come fluiscono i pagamenti

• Le builder fees maturano all'esecuzione e sono denominate in basis point dell'operazione.
• I builder Verified ricevono ricompense settimanali in USDC basate sul volume oltre alle builder fees; il tier Partner riceve ricompense potenziate secondo il programma di Polymarket.
• Polymarket gestisce i pagamenti reali e le formule dietro le ricompense settimanali; i builder dovrebbero usare la dashboard su polymarket.com/settings per reportistica e dettagli sui pagamenti.

Note operative e sui rischi

• I rate limit del Relayer sono importanti: applica throttling locale per evitare richieste respinte e comportamenti imprevisti.
• Gli ordini instradati tramite il Relayer sono soggetti alle regole del CLOB di Polymarket: comportamento del tick size, la semantica FAK per gli ordini di mercato e le regole maker/taker (i maker pagano zero maker fees).
• I builder non eliminano altri rischi intrinseci al trading su mercati predittivi: rischio di risoluzione (i dispute UMA possono ritardare il settlement), slippage e fill parziali, e rischio smart-contract. Mostra sempre questi rischi ai tuoi utenti.

Come questo influisce sulla tua infrastruttura di trading

H2: Impatto pratico sui tuoi sistemi

Se gestisci un livello di routing o un aggregatore, il Builder Program cambia due cose: puoi ricevere ricavi diretti per gli ordini che instradi e devi gestire attribuzione e limiti del relayer. Usa il Relayer Client per le operazioni su wallet e token per evitare di reimplementare la logica CTF e gasless. Progetta il tuo sistema per registrare l'attribuzione per ordine, tracciare le builder fees accumulate in basis point e riconciliare i pagamenti settimanali da Polymarket.

Riepilogo finale

Il Polymarket Builder Program è una via pensata per sviluppatori per aggiungere flusso di ordini al CLOB di Polymarket con attribuzione e una quota di ricavo. Per i builder, i principali compiti operativi sono ottenere le credenziali, integrare gli header di attribuzione, usare il Polymarket Relayer Client (TypeScript o Python) e rispettare i limiti di relayer per tier. Le builder fees sono pagate in basis point all'esecuzione e i builder Verified/Partner ricevono meccanismi di ricompensa aggiuntivi gestiti da Polymarket.

Per dettagli tecnici sul CLOB e sulla semantica di mercato, vedi /guides/polymarket-clob-explained e per capire la struttura delle fee su Polymarket vedi /guides/polymarket-fees-explained.

Domande frequenti

Quali sono i tier e i limiti del Polymarket Builder Program?

Ci sono tre livelli: Unverified (limite giornaliero relayer 100), Verified (limite giornaliero relayer 10.000 più ricompense settimanali in USDC e builder fees) e Partner (limite relayer illimitato e supporto elevato). Questi livelli controllano i rate limit e l'idoneità alle ricompense.

Come vengono pagate le builder fees di Polymarket?

Le builder fees sono configurate in basis point e vengono pagate al builder accreditato quando un ordine viene eseguito. I builder Verified ricevono inoltre ricompense settimanali in USDC basate sul volume; le meccaniche precise di payout sono gestite da Polymarket.

Devo gestire il gas o il deployment dei wallet?

No. Il Polymarket Relayer sponsorizza il gas per gli utenti finali. Il Relayer Client SDK (TypeScript e Python) gestisce il deployment dei wallet (Proxy o Gnosis Safe), le approvazioni pUSD e le operazioni CTF così puoi concentrarti sulla logica di routing.

Come faccio a essere sicuro che i miei trade siano accreditati al mio account builder?

Includi gli header di attribuzione richiesti nelle richieste instradate. Il Relayer usa quegli header per accreditare il tuo builder. Usa il Relayer Client ufficiale per assicurarti che header e firme siano corrette.

Dove prendo le credenziali e le impostazioni del builder?

Le credenziali e le impostazioni del builder sono gestite su polymarket.com/settings. Quella dashboard controlla l'emissione delle credenziali, l'assegnazione del tier e la reportistica.