Gamma API

Polymarket Gamma API est l'API REST publique qui expose les données au niveau marché : markets, events, tags, series et profiles. Les développeurs et traders l'utilisent pour lister des marchés, récupérer les métadonnées d'événements et construire des pages d'index ou des annuaires de marchés sans authentification.

Points clés

L'API Gamma est publique et ne nécessite aucune authentification pour les lectures. Utilisez-la pour lister markets, events, tags, series et profiles.
/markets est soumis à une limite de débit : 300 requêtes par 10 secondes. La pagination utilise after_cursor basée sur un curseur (offset est rejeté).
Les paramètres utiles incluent limit (max 1000), after_cursor, des filtres tableaux comme slug ou condition_ids, et des flags booléens tels que closed ou active.
Combinez /markets et /events avec précaution : la limite combinée de listing est de 900 req / 10 s ; la limite globale de l'API est de 4000 req / 10 s.

Comment utiliser la Gamma API

La Gamma API est la surface publique canonique pour les données d'affichage relatives aux marchés Polymarket. Les front-ends, agrégateurs et outils de recherche appellent des endpoints comme /markets et /events pour remplir des listes de marchés, des pages de catégories et des filtres de tags.

Paramètres et comportements importants

limit : Contrôle la taille de la page. Par défaut 20, maximum 1000.
after_cursor : Pagination basée sur curseur ; offset est rejeté avec HTTP 422 — n'utilisez pas d'offsets.
Filtrage : Plusieurs paramètres de requête acceptent des tableaux (par exemple slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
Flags : closed (par défaut false), active, et archived filtrent par état du marché.
Ordre : Le paramètre order accepte une liste de champs séparés par des virgules (par exemple volume24hr,volume,liquidity,endDate), associé à ascending (booléen).

Limites de débit et recommandations pratiques

Limite spécifique à /markets : 300 requêtes par 10 secondes.
Limite combinée de listing pour /markets + /events : 900 requêtes par 10 secondes.
Surface globale de l'API Gamma : 4000 requêtes par 10 secondes.

Si vous prévoyez un indexage à haut débit, implémentez un backoff exponentiel et respectez le schéma de pagination basé sur curseur. Mettez en cache les listings quand cela est approprié ; évitez de sonder la même ressource de manière agressive.

Exemple de requête (curl)

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

Contexte sur Polymarket

Gamma est l'API publique en lecture non authentifiée que vous utiliserez lorsque vous avez besoin de métadonnées de marché pour des listes UI, des pages de tags ou des intégrations qui ne requièrent pas l'état on-chain (pour les positions on-chain et les trades, utilisez la Data API ; pour les opérations sur le carnet d'ordres, utilisez la CLOB API). Parce que Gamma est en lecture seule et publique, c'est l'endroit approprié pour construire des annuaires de marchés et des outils exploratoires.

Voir aussi

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

Note de clôture

Polymarket Gamma API est le premier arrêt pour les métadonnées de marché. Utilisez les paramètres documentés et respectez les limites de débit pour éviter les requêtes rejetées.

Gamma API

Termes connexes