EN VIVO
$7.62 de ganancia mínima por operación / por operación
Obtén el bot
PolyArb
bot

Documentación de la API de Polymarket: endpoints, límites de tasa y uso

Si buscaste "polymarket api docs" quieres los endpoints exactos, el modelo de autenticación y los límites prácticos para construir o integrar con Polymarket. A continuación están las tres REST públicas y el WebSocket de mercado que usarás, además de los parámetros clave y los límites de tasa. También explico qué requiere el CLOB para tradear y cómo PolyArb aprovecha estas superficies para encontrar arbitraje intra-market.

Obtén el bot — $99/mesCalculadora de arbitraje

Endpoints oficiales de la API y mapa de superficies

Polymarket expone tres superficies REST públicas y un WebSocket de mercado. La Gamma API para markets y events está en https://gamma-api.polymarket.com. La Data API para positions, trades y open interest está en https://data-api.polymarket.com. La CLOB API para order book y trading está en https://clob.polymarket.com. El socket de mercado en tiempo real es wss://ws-subscriptions-clob.polymarket.com/ws/market. Cada superficie tiene su propósito: Gamma es para listings y filtros, Data es para actividad histórica y derivada on-chain, CLOB es para lecturas del libro en vivo y colocación de órdenes (las lecturas son públicas; el trading requiere API key + HMAC). El WebSocket emite streams de book y eventos de price-change para hasta 500 instrumentos por conexión.

Parámetros y límites de Gamma /markets

El endpoint /markets de Gamma soporta paginación por keyset: usa after_cursor devuelto por la llamada anterior; offset es rechazado con HTTP 422. Parámetros útiles incluyen limit (máx. 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending y tag_id. Límites de tasa: /markets está limitado a 300 requests por 10 segundos; las llamadas combinadas de listing /markets + /events están limitadas a 900 requests por 10 segundos. La asignación total de la API Gamma es de 4000 requests por 10 segundos.

CLOB y mecánica de trading

CLOB expone order book, midpoint, price history y colocación/cancelación de órdenes. El trading requiere una API key más HMAC; las lecturas son públicas. El tick size de Polymarket, los eventos best_bid_ask y el helper de orden de mercado FAK están disponibles a través de CLOB y el WebSocket de mercado. Recuerda que las comisiones maker son cero y las taker varían según la categoría. Si construyes un agente de trading enrutado, considera el Builder Program de Polymarket para atribución y recompensas por builder-fees.

Cómo PolyArb usa estas APIs

PolyArb consulta Gamma y el libro de CLOB y se suscribe al WebSocket de mercado para detectar oportunidades de arbitraje intra-market donde Σ bestAsk < $1.00. Nuestro bot corre en infraestructura de baja latencia (plan 40ms) para ganarle a bots gratuitos (~800ms), con un plan de $99/month y un edge mínimo garantizado de $7.62 por operación. Combinamos eventos en vivo best_bid_ask, el midpoint del CLOB y el historial de la Data API para dimensionar órdenes y evitar fills parciales. Ten en cuenta los riesgos operativos habituales: disputas de resolución vía UMA, slippage, cambios de comisiones, tiempos de liquidación y riesgo de smart-contract.

Empieza a arbitrar en Polymarket con PolyArb hoy

Suscríbete a PolyArb por $99/month para obtener 40ms de latencia, alertas en Telegram y Discord, ejecución no custodial y nuestro edge mínimo garantizado de $7.62 por operación.

Obtén el bot — $99/mes

FAQ

¿Cuáles son las URLs base oficiales de la API de 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.
¿Necesito autenticación para leer datos de mercado?
No. Las lecturas desde Gamma, Data y los endpoints públicos de CLOB son sin autenticación. Colocar órdenes en CLOB requiere una API key más HMAC.
¿Cuáles son los límites de tasa importantes para /markets?
/markets está limitado a 300 requests por 10 segundos. Las llamadas combinadas de listing /markets y /events están limitadas a 900 requests por 10 segundos. El límite total de la API Gamma es de 4000 req por 10 segundos.
¿Puedo usar el WebSocket para actualizaciones en tiempo real del order book?
Sí. El WebSocket de mercado proporciona eventos en tiempo real de book, price_change, best_bid_ask, last_trade_price y tick_size_change. Hace ping cada 10 segundos y soporta hasta 500 instrumentos por conexión.

Related topics