Documentazione Polymarket: guida rapida per trader
La documentazione di Polymarket copre le API, le meccaniche di mercato, le commissioni e la logica dei token on‑chain necessarie ai trader per costruire strumenti o strategie di arbitraggio. Questa guida riassume la documentazione realmente utile: le API Gamma, Data e CLOB; le meccaniche dei token CTF; e il modello di relayer che rende il trading gasless. Se vuoi un setup di arbitraggio in produzione, PolyArb si basa sugli stessi primitive e aggiunge latenza di 40ms, alert su Telegram e Discord, e un edge minimo garantito di $7.62.
API principali di Polymarket che userai
Polymarket espone tre surface REST e un WebSocket di mercato. Usa Gamma (https://gamma-api.polymarket.com) per markets, events e tags; Data (https://data-api.polymarket.com) per positions, trades e open interest; e CLOB (https://clob.polymarket.com) per letture dell'orderbook e invio ordini. Il market WebSocket (wss://ws-subscriptions-clob.polymarket.com/ws/market) trasmette in tempo reale book ed eventi di trade. La paginazione e i rate limit sono importanti: Gamma usa keyset pagination con after_cursor e limiti su /markets. CLOB richiede API key + HMAC per le chiamate di trading; le letture sono pubbliche. Costruisci gli strumenti usando esattamente questi endpoint per evitare sorprese.
Meccaniche di mercato nella documentazione
Polymarket usa un Central Limit Order Book e il Conditional Token Framework di Gnosis per i token di outcome (ERC-1155). I prezzi dei binary a fair value sommano a $1.00; i mercati multi-outcome sommano a $1.00 attraverso tutti gli outcome. La documentazione spiega i flussi di split/merge/redeem per set completi e le regole di tick size che si restringono vicino a 0.96/0.04. Le operazioni vengono eseguite gasless tramite il Polymarket Relayer, che gestisce anche il deployment dei wallet e le approvazioni. Le commissioni maker sono zero; le taker fees variano per categoria.
Dove la documentazione non ti fornisce un bot
La documentazione è completa per costruire un client ma non include uno stack di arbitraggio a bassa latenza pronto all'uso. Latenza, gestione ordini e gestione di dispute/risoluzioni sono problemi di ingegneria sopra le API. L'oracolo ottimista UMA di Polymarket e le finestre di disputa introducono rischi di risoluzione e tempistiche di settlement che devi gestire tramite codice. Se desideri un servizio di arbitraggio chiavi in mano, PolyArb usa le stesse API e primitive ma aggiunge infrastruttura di esecuzione, alert e un edge minimo garantito per trade.
Per iniziare e passi successivi
Inizia leggendo Gamma /markets e la documentazione dell'orderbook CLOB, collega il market WebSocket e testa i flussi di split/merge su Polygon con pUSD. Rispetta le restrizioni geografiche indicate nella documentazione: diversi paesi sono bloccati e l'uso di VPN è proibito dai Terms of Service. Quando ti serve esecuzione in produzione, PolyArb offre un'opzione gestita: latenza di 40ms rispetto ai tipici bot gratuiti, funzionamento non-custodial, alert su Telegram + Discord e un edge minimo garantito di $7.62.
Prova PolyArb per esecuzione Polymarket a bassa latenza
Ottieni esecuzione di arbitraggio non-custodial, alert su Telegram e Discord, e un edge minimo garantito di $7.62 — il tutto per $99/month. Inizia a fare trading live con fill più rapidi e monitoraggio attivo.
FAQ
- Dove sono gli endpoint API ufficiali di Polymarket?
- Le tre REST API sono Gamma (https://gamma-api.polymarket.com), Data (https://data-api.polymarket.com) e CLOB (https://clob.polymarket.com). I dati di mercato in tempo reale sono su wss://ws-subscriptions-clob.polymarket.com/ws/market.
- Polymarket richiede gas o token speciali per fare trading?
- Il trading usa pUSD (il wrapped USDC di Polymarket) su Polygon. Polymarket sponsorizza il gas tramite il suo Relayer, quindi il deployment del wallet, le approvazioni e le operazioni CTF sono gasless per gli utenti finali.
- Posso costruire un bot di arbitraggio solo dalla documentazione?
- La documentazione fornisce le primitive, ma l'arbitraggio in produzione richiede esecuzione a bassa latenza, gestione ordini e gestione del rischio di risoluzione. Molti trader preferiscono runtime gestiti come PolyArb per esecuzione e monitoraggio.
- Come funzionano split, merge e redeem?
- Sono operazioni CTF: split minta un set completo da $1.00 di pUSD, merge li brucia indietro, e redeem converte i token dell'outcome vincente in $1.00 dopo la risoluzione. La documentazione dettaglia i flussi contrattuali esatti.
Related topics
- Polymarket: come funziona la piattaforma di prediction market
- Kalshi vs Polymarket: cosa devono sapere i trader
- Scommesse Kalshi vs Polymarket: cosa devono sapere i trader
- kalshi bets: come si confrontano con il trading su Polymarket
- Scommessa Kalshi vs Polymarket: cosa devono sapere i trader
- PredictIt: come si confronta con Polymarket e PolyArb