Si buscaste la API de Polymarket o la documentación de Polymarket, aquí está la respuesta corta: sí, Polymarket tiene una API para desarrolladores completa y en su mayoría pública, y esta guía la mapea para que puedas empezar a leer mercados o a construir en minutos. Polymarket expone tres servicios REST y un canal WebSocket, y la mayor parte no necesita clave alguna. A continuación verás qué hace cada parte, cómo funciona la autenticación, los endpoints que realmente usarás, los SDKs oficiales y qué puedes construir, con enlaces a la referencia oficial para los parámetros exactos.
No es asesoramiento financiero. Esta es una guía técnica. Operar en mercados de predicción implica dinero real y un riesgo real de pérdida, y el acceso está sujeto a las restricciones geográficas de Polymarket. Cumple con la ley de tu jurisdicción, verifica todo contra la documentación oficial y lee primero nuestro descargo de riesgos.
Conclusiones clave
- Polymarket tiene tres APIs REST más un WebSocket: Gamma (datos), CLOB (trading), Data (analítica).
- Leer mercados, precios y rankings es gratis y sin clave en las APIs Gamma y Data.
- El trading corre a través de la CLOB API y se autentica firmando con tu wallet de Polygon, no con una clave de API clásica.
- Existen SDKs oficiales para Python (py-clob-client), TypeScript y Rust, y cualquier cliente HTTP sirve para leer.
- La referencia oficial en docs.polymarket.com es la fuente de verdad para los endpoints y límites exactos.
El mapa: tres APIs y un WebSocket
Polymarket divide su API por función, lo que mantiene cada pieza simple. La tabla de abajo es el modelo mental que conviene tener.
| Servicio | URL base | Para qué sirve | Auth |
|---|---|---|---|
| Gamma API | gamma-api.polymarket.com | Mercados, eventos, etiquetas, series, búsqueda, perfiles públicos | Pública, sin clave |
| CLOB API | clob.polymarket.com | Libros de órdenes, precios, puntos medios, spreads, historial de precios, colocación y cancelación de órdenes | Lecturas públicas, operaciones firmadas con wallet |
| Data API | data-api.polymarket.com | Posiciones, operaciones, actividad, poseedores, interés abierto, rankings | Pública, sin clave |
| WebSocket | wss://ws-subscriptions-clob.polymarket.com | Actualizaciones en vivo del libro de órdenes y de precios, y el estado de tus propias órdenes | Canal de mercado público, canal de usuario autenticado |
La mayoría de las aplicaciones leen de Gamma y de la Data API y nunca necesitan autenticarse. Solo recurres al lado autenticado de CLOB cuando de verdad quieres colocar o cancelar órdenes.
Gamma API: el catálogo de mercados
La Gamma API en gamma-api.polymarket.com es donde encuentras lo que existe. Los dos endpoints que usarás constantemente son markets y events, donde un evento agrupa uno o más mercados relacionados (una sola pregunta puede tener varios mercados de resultado por debajo). Gamma también sirve etiquetas, series, deportes, búsqueda y perfiles públicos. Es totalmente pública, así que una simple petición GET devuelve los metadatos del mercado, los precios actuales y los token ID que necesitas para todo lo demás. Si estás construyendo un panel, un buscador de mercados o la capa de descubrimiento de un bot, empiezas aquí.
CLOB API: el libro de órdenes y el trading
La CLOB API en clob.polymarket.com es el exchange. Su lado público te da el libro de órdenes, los precios, los puntos medios, los spreads y el historial de precios de cualquier token de mercado. Su lado autenticado es donde ocurre el trading: construyes una orden con un token ID, un precio, un tamaño y un lado (compra o venta), la firmas con tu wallet y la envías, y puedes cancelar órdenes de la misma manera.
La autenticación aquí es la parte que sorprende a quienes vienen de APIs tradicionales. No hay una clave que pegues desde un panel. En su lugar te autenticas firmando mensajes con tu wallet de Ethereum o Polygon, lo que demuestra que controlas los fondos sin entregar un secreto a un servidor. Los SDKs oficiales gestionan este flujo de firma por ti, que es la razón principal para usarlos al operar en lugar de hacerlo a mano.
Data API: posiciones, operaciones y rankings
La Data API en data-api.polymarket.com es la capa analítica. Expone posiciones de usuarios, operaciones, actividad, datos de poseedores, interés abierto, analítica de builders y los rankings públicos. Esta es la API detrás de funciones del estilo “quién posee qué” y “quién va más arriba”. Es totalmente pública, lo que la hace ideal para investigación, paneles de análisis de copia y cualquier cosa que estudie el comportamiento en lugar de colocar órdenes. Si quisieras estudiar cómo están posicionados los mejores traders, aquí es donde viven esos datos.
WebSocket: actualizaciones en vivo
Sondear los endpoints REST en un bucle está bien para datos lentos, pero para cualquier cosa en vivo conviene el WebSocket en wss://ws-subscriptions-clob.polymarket.com. Suscríbete al canal de mercado para actualizaciones públicas del libro de órdenes y de precios, o al canal de usuario, que está autenticado, para el estado de tus propias órdenes en tiempo real. Los paneles en vivo, los bots de creación de mercado y los sistemas de alertas viven todos en el WebSocket, porque te envía los cambios en lugar de obligarte a preguntar una y otra vez.
SDKs oficiales y lenguajes
No necesitas un SDK para leer datos, una simple petición HTTP funciona en cualquier lenguaje, pero para operar los clientes oficiales ahorran trabajo real. Polymarket mantiene un cliente de Python (py-clob-client), además de clientes de TypeScript y Rust, y la comunidad ha añadido más. Los SDKs gestionan la firma de la wallet, la construcción de órdenes y los pequeños detalles que es fácil hacer mal a mano. Para un proyecto de solo lectura, curl o fetch bastan; para un proyecto de trading, parte de un SDK oficial.
Qué puedes construir
La API abre unos cuantos proyectos claros. Un panel o buscador de mercados de solo lectura obtiene de Gamma más la Data API y no necesita autenticación alguna. Una herramienta de investigación que estudia el posicionamiento y los rankings vive por entero en la Data API. Un widget de cuotas en vivo o un bot de alertas se monta sobre el WebSocket. Y un bot de trading usa un SDK oficial para firmar y enviar órdenes a través de CLOB, idealmente tras una larga fase de paper trading. Para el lado manual de los mismos mercados, nuestras guías sobre cómo operar en Polymarket y las comisiones de Polymarket cubren la mecánica, y cómo el oráculo de UMA resuelve los mercados explica la liquidación sobre la que tu código apuesta en última instancia.
Notas prácticas y trampas
Unas cuantas cosas ahorran tiempo. Trata los endpoints públicos como limitados por tasa: cachea las respuestas, retrocede ante los errores y no sondees en un bucle ajustado cuando existe el WebSocket. Los token ID, no los nombres de los mercados, son las claves que enlazan Gamma, CLOB y la Data API, así que consíguelos pronto. Los precios son probabilidades entre 0 y 1, no dólares, así que la matemática de tamaño y riesgo debe respetarlo. Y como el trading es dinero real en cadena sobre Polygon, prueba con el tamaño más pequeño posible, gestiona las ejecuciones parciales y los fallos, y nunca despliegues una estrategia que no hayas validado. Confirma siempre las rutas exactas de los endpoints, los parámetros y los límites contra la referencia oficial de la API, ya que esa es la fuente autorizada y actual.
En resumen
La API de Polymarket es más accesible de lo que sugiere su reputación: tres servicios REST y un WebSocket, con el lado de datos totalmente público y solo el trading protegido tras la firma de la wallet. Lee con Gamma y la Data API, ponte en vivo con el WebSocket y opera a través de CLOB con un SDK oficial. Construye primero de solo lectura, valida con cuidado y respeta las restricciones geográficas y tu ley local antes de cualquier operación real. ¿Nuevo en la plataforma en sí? Empieza con qué es Polymarket y los mejores mercados que vigilar, y luego vuelve para construir.
Este artículo es información técnica general, no asesoramiento financiero ni legal. Operar en mercados de predicción conlleva un riesgo real de pérdida, las APIs y los endpoints cambian, y el acceso está restringido geográficamente. Verifica contra la documentación oficial, lee nuestro descargo de riesgos y nunca arriesgues dinero que no puedas permitirte perder.
Preguntas frecuentes
¿Tiene Polymarket una API pública?
Sí. Polymarket expone una API completa para desarrolladores dividida en tres servicios REST, la Gamma API para datos de mercados y eventos, la CLOB API para el libro de órdenes y el trading, y la Data API para posiciones, operaciones y rankings, además de un canal WebSocket para actualizaciones en vivo. Las APIs Gamma y Data son totalmente públicas y no requieren clave. La referencia oficial está en docs.polymarket.com, y debes tratarla como la fuente de verdad para los parámetros exactos.
¿Es gratis la API de Polymarket y necesito una clave?
Leer datos es gratis y en su mayoría no requiere clave. La Gamma API (gamma-api.polymarket.com) y la Data API (data-api.polymarket.com) son totalmente públicas, así que puedes obtener mercados, precios, posiciones y rankings sin autenticación. La CLOB API (clob.polymarket.com) es pública para leer el libro de órdenes y los precios, pero colocar o cancelar órdenes requiere autenticación. No hay un registro clásico de clave de API, te autenticas firmando con tu wallet.
¿Cuál es la diferencia entre las APIs Gamma, CLOB y Data?
Gamma (gamma-api.polymarket.com) es el catálogo: mercados, eventos, etiquetas, búsqueda y perfiles. CLOB (clob.polymarket.com) es el exchange: libros de órdenes, precios, puntos medios, spreads, historial de precios y colocación o cancelación de órdenes. La Data API (data-api.polymarket.com) es analítica: posiciones de usuarios, operaciones, actividad, poseedores, interés abierto y rankings. La mayoría de las apps leen de Gamma y Data, y solo tocan el lado autenticado de CLOB para operar.
¿Puedo colocar operaciones a través de la API de Polymarket?
Sí, a través de los endpoints autenticados de la CLOB API. Construyes una orden con un token ID, precio, tamaño y lado (compra o venta), la firmas con tu wallet de Polygon y la envías. Esto es dinero real en cadena, así que prueba primero con un tamaño mínimo, gestiona errores y ejecuciones parciales, y nunca ejecutes una estrategia que no hayas validado. Operar en mercados de predicción conlleva un riesgo real de pérdida. Esto no es asesoramiento financiero.
¿Qué lenguajes y SDKs admite Polymarket?
Polymarket mantiene un cliente oficial de Python (py-clob-client) y clientes de TypeScript y Rust, y la comunidad ha creado librerías en otros lenguajes. Como todo es REST y WebSocket sobre HTTP, también puedes usar curl simple, Go o cualquier lenguaje con un cliente HTTP. Para operar en concreto, vale la pena usar los SDKs oficiales porque gestionan por ti la firma de la wallet y el formato de las órdenes.
¿Hay un WebSocket para datos de Polymarket en vivo?
Sí. Conéctate al WebSocket de CLOB en wss://ws-subscriptions-clob.polymarket.com y suscríbete al canal de mercado para actualizaciones públicas del libro de órdenes y de precios, o al canal de usuario (autenticado) para el estado de tus propias órdenes. Los WebSockets son la herramienta adecuada para paneles en vivo, bots de trading y cualquier cosa que necesite actualizaciones por debajo del segundo, ya que sondear los endpoints REST por los mismos datos es más lento y pesado.
¿Hay límites de tasa y puedo usar la API desde cualquier país?
Trata los endpoints públicos como limitados por tasa y cachea de forma agresiva, retrocede ante los errores y consulta la documentación oficial para los límites actuales en lugar de saturarlos. El acceso también está sujeto a las restricciones geográficas de Polymarket, que están documentadas y se aplican, así que la API no es una vía para saltarse las reglas regionales. Cumple con la ley de tu jurisdicción. Este artículo es información general, no asesoramiento legal ni financiero.
#Polymarket#API#CLOB#developers#prediction markets#guide
Debate
Cargando comentarios…