EN DIRECT
7,62 $ de profit min par trade
Obtenir le bot
bot

Documentation API Polymarket : endpoints, limites de débit et utilisation

Si vous avez cherché « polymarket api docs », vous voulez les endpoints exacts, le modèle d'authentification et les limites pratiques pour construire ou intégrer Polymarket. Ci‑dessous se trouvent les trois API REST publiques et le WebSocket marché que vous utiliserez, ainsi que les paramètres clés et les limites de débit. J’explique aussi ce que le CLOB exige pour trader et comment PolyArb exploite ces surfaces pour trouver de l’arbitrage intra‑market.

Endpoints officiels de l'API et cartographie des surfaces

Polymarket expose trois surfaces REST publiques et un WebSocket marché. L'API Gamma pour les markets et events est à https://gamma-api.polymarket.com. L'API Data pour les positions, trades et open interest est à https://data-api.polymarket.com. L'API CLOB pour le carnet d'ordres et le trading est à https://clob.polymarket.com. Le socket marché temps réel est wss://ws-subscriptions-clob.polymarket.com/ws/market. Chaque surface a son utilité : Gamma sert aux listings et filtres, Data couvre l’historique et l’activité dérivée de la chaîne, CLOB fournit les lectures du carnet en direct et le placement d’ordres (les lectures sont publiques ; le trading nécessite une API key + HMAC). Le WebSocket diffuse des événements de carnet et de variation de prix pour jusqu’à 500 instruments par connexion.

Paramètres et limites de Gamma /markets

Le endpoint /markets de Gamma supporte la pagination par keyset : utilisez after_cursor retourné par l'appel précédent ; offset est rejeté avec HTTP 422. Les paramètres de requête utiles incluent limit (max 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending et tag_id. Limites de débit : /markets est limité à 300 requêtes par 10 secondes ; les appels combinés /markets + /events sont limités à 900 requêtes par 10 secondes. L'allocation globale de l'API Gamma est de 4000 requêtes par 10 secondes.

CLOB et mécanismes de trading

CLOB expose le carnet d'ordres, le midpoint, l'historique des prix et le placement/annulation d'ordres. Le trading nécessite une API key plus HMAC ; les lectures sont publiques. La tick size de Polymarket, les événements best_bid_ask et l'aide pour les ordres market FAK sont disponibles via CLOB et le WebSocket marché. Souvenez‑vous que les frais maker sont nuls et que les frais taker varient selon la catégorie. Si vous construisez un routeur d'ordres, considérez le Builder Program de Polymarket pour l'attribution et les récompenses en builder-fee.

Comment PolyArb utilise ces APIs

PolyArb interroge Gamma et le carnet CLOB et s'abonne au WebSocket marché pour détecter les opportunités d'arbitrage intra‑market où Σ bestAsk < $1.00. Notre bot tourne sur une infrastructure basse latence (plan 40ms) pour battre les bots gratuits (~800ms), avec un plan à $99/month et une marge minimale garantie de $7.62 par trade. Nous combinons les événements live best_bid_ask, le midpoint CLOB et l'historique de l'API Data pour dimensionner les ordres et éviter les fills partiels. Notez les risques opérationnels habituels : disputes de résolution via UMA, slippage, changements de frais, délai de settlement et risque de smart‑contract.

Commencez à arbitrer Polymarket avec PolyArb dès aujourd'hui

Abonnez‑vous à PolyArb pour $99/month et obtenez 40ms de latence, des alertes Telegram et Discord, une exécution non‑custodiale, et notre marge minimale garantie de $7.62 par trade.

FAQ

Où trouver les URLs de base officielles des 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.
Ai‑je besoin d'authentification pour lire les données de marché ?
Non. Les lectures depuis Gamma, Data et les endpoints publics de CLOB sont non authentifiées. Placer des ordres sur CLOB nécessite une API key plus HMAC.
Quelles sont les limites de débit importantes pour /markets ?
/markets est limité à 300 requêtes par 10 secondes. Les appels combinés /markets et /events sont limités à 900 requêtes par 10 secondes. La limite globale de l'API Gamma est de 4000 req par 10 secondes.
Puis‑je utiliser le WebSocket pour des mises à jour en temps réel du carnet d'ordres ?
Oui. Le WebSocket marché fournit des événements temps réel : book, price_change, best_bid_ask, last_trade_price et tick_size_change. Il envoie un ping toutes les 10 secondes et supporte jusqu'à 500 instruments par connexion.

Related topics