LIVE
Il minimo profitto di $7.62 è tuo / per trade
Prendi il bot
bot

Documentazione API Polymarket: endpoint, limiti di richiesta e utilizzo

Se hai cercato "polymarket api docs" vuoi gli endpoint esatti, il modello di autenticazione e i limiti pratici per costruire o integrare con Polymarket. Di seguito trovi le tre REST API pubbliche e il WebSocket di mercato che userai, più i parametri chiave e i limiti di richiesta. Copro anche cosa richiede la CLOB per il trading e come PolyArb sfrutta queste superfici per trovare arbitraggio intra-market.

Endpoint ufficiali delle API e mappa delle superfici

Polymarket espone tre superfici REST pubbliche e un WebSocket di mercato. La Gamma API per mercati ed eventi è su https://gamma-api.polymarket.com. La Data API per posizioni, trade e open interest è su https://data-api.polymarket.com. La CLOB API per order book e trading è su https://clob.polymarket.com. Il socket di mercato in tempo reale è wss://ws-subscriptions-clob.polymarket.com/ws/market. Ogni superficie ha il suo scopo: Gamma è per listing e filtri, Data fornisce dati storici e derivati on-chain, CLOB è per letture live dell’order-book e piazzamento ordini (le letture sono pubbliche; il trading richiede API key + HMAC). Il WebSocket streamma eventi di book e price-change fino a 500 strumenti per connessione.

Parametri e limiti di Gamma /markets

L’endpoint /markets di Gamma supporta la paginazione keyset: usa after_cursor restituito dalla chiamata precedente; offset viene rifiutato con HTTP 422. Parametri utili includono limit (max 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending e tag_id. Limiti di rate: /markets è limitato a 300 richieste ogni 10 secondi; le chiamate combinate /markets + /events sono limitate a 900 richieste ogni 10 secondi. La capacità complessiva della Gamma API è 4000 richieste ogni 10 secondi.

CLOB e meccaniche di trading

CLOB espone order book, midpoint, storico prezzi e piazzamento/annullamento ordini. Il trading richiede una API key più HMAC; le letture sono pubbliche. La tick size di Polymarket, gli eventi best_bid_ask e l’helper per ordini di mercato FAK sono esposti tramite CLOB e il WebSocket di mercato. Ricorda che le commissioni maker sono zero e le taker variano per categoria. Se costruisci un agente di trading routed, considera il Builder Program di Polymarket per attribuzione e ricompense in builder-fee.

Come PolyArb usa queste API

PolyArb interroga Gamma e il book CLOB e si iscrive al WebSocket di mercato per rilevare opportunità di arbitraggio intra-market dove Σ bestAsk < $1.00. Il nostro bot gira su infrastruttura a bassa latenza (piano 40ms) per battere i bot gratuiti (~800ms), con un piano da $99/month e un margine minimo garantito di $7.62 per trade. Combiniamo eventi live best_bid_ask, il midpoint CLOB e la storia della Data API per dimensionare gli ordini ed evitare fill parziali. Nota i rischi operativi usuali: dispute di risoluzione tramite UMA, slippage, variazioni di commissioni, tempi di settlement e rischio smart-contract.

Inizia ad arbitrare su Polymarket con PolyArb oggi

Abbonati a PolyArb per $99/month per ottenere 40ms di latenza, avvisi su Telegram e Discord, esecuzione non-custodial e il nostro margine minimo garantito di $7.62 per trade.

FAQ

Quali sono le URL base ufficiali delle API Polymarket?
Gamma: https://gamma-api.polymarket.com; Data: https://data-api.polymarket.com; CLOB: https://clob.polymarket.com; WebSocket: wss://ws-subscriptions-clob.polymarket.com/ws/market.
Serve autenticazione per leggere i dati di mercato?
No. Le letture da Gamma, Data e dagli endpoint pubblici di CLOB non richiedono autenticazione. Per piazzare ordini su CLOB è necessaria una API key più HMAC.
Quali sono i limiti di rate importanti per /markets?
/markets è limitato a 300 richieste ogni 10 secondi. Le chiamate combinate /markets e /events sono limitate a 900 richieste ogni 10 secondi. Il limite complessivo della Gamma API è 4000 req ogni 10 secondi.
Posso usare il WebSocket per aggiornamenti real-time dell’order book?
Sì. Il WebSocket di mercato fornisce in tempo reale eventi di book, price_change, best_bid_ask, last_trade_price e tick_size_change. Invia un ping ogni 10 secondi e supporta fino a 500 strumenti per connessione.

Related topics