Gamma API

Polymarket Gamma API è l'API REST pubblica che espone dati a livello di mercato: markets, events, tags, series e profiles. Sviluppatori e trader la usano per elencare mercati, recuperare metadati degli eventi e costruire pagine indice o directory di mercato senza autenticazione.

Punti chiave

• La Gamma API è pubblica e non richiede autenticazione per le letture. Usala per elencare markets, events, tags, series e profiles.
• /markets è soggetta a rate limit: 300 richieste ogni 10 secondi. La paginazione usa after_cursor basato su cursore (gli offset vengono rifiutati).
• Parametri di query utili includono limit (max 1000), after_cursor, array di filtraggio come slug o condition_ids, e flag booleani come closed o active.
• Combina /markets e /events con attenzione: il limite combinato per le listing è 900 req / 10 s; il limite complessivo dell'API è 4000 req / 10 s.

Come si usa la Gamma API

La Gamma API è la surface pubblica canonica per i dati orientati alla visualizzazione sui mercati di Polymarket. Front-end, aggregator e strumenti di ricerca chiamano endpoint come /markets e /events per popolare liste di mercato, pagine di categoria e filtri per tag.

Parametri e comportamenti importanti

• limit: Controlla la dimensione della pagina. Default 20, massimo 1000.
• after_cursor: Paginazione basata su cursore; offset viene rifiutato con HTTP 422—non usare offset.
• Filtri: Diversi parametri di query accettano array (per esempio slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
• Flag: closed (default false), active e archived filtrano per stato del mercato.
• Ordinamento: Il parametro order accetta una lista di campi separati da virgola (per esempio volume24hr,volume,liquidity,endDate), abbinato a ascending (booleano).

Rate limit e consigli pratici

• Limite specifico per /markets: 300 richieste ogni 10 secondi.
• Limite combinato per le listing di /markets + /events: 900 richieste ogni 10 secondi.
• Superficie complessiva della Gamma API: 4000 richieste ogni 10 secondi.

Se prevedi indicizzazione ad alto throughput, implementa backoff esponenziale e rispetta il pattern di paginazione basato su cursore. Memorizza in cache le listing quando appropriato; evita di interrogare ripetutamente la stessa risorsa in modo aggressivo.

Esempio di richiesta (curl)

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

Nel contesto di Polymarket

Gamma è l'API di sola lettura pubblica e non autenticata che userai quando hai bisogno di metadati di mercato per liste UI, pagine di tag o integrazioni che non richiedono stato on-chain (per posizioni e trade on-chain usa la Data API; per operazioni sull'order-book usa la CLOB API). Poiché Gamma è di sola lettura e pubblica, è il luogo giusto per costruire directory di mercato e strumenti esplorativi.

Vedi anche

• /glossary/data-api
• /glossary/clob-api

Nota finale

Polymarket Gamma API è il primo punto di riferimento per i metadati di mercato. Usa i parametri documentati e rispetta i rate limit per evitare richieste rifiutate.