API de Polymarket: guía en español

Polymarket publica sus datos de mercado en API públicas y gratuitas, y permite operar de forma programática a través de su libro de órdenes (el CLOB). Leer precios, mercados y rankings no necesita cuenta; enviar órdenes necesita una billetera de Polymarket con fondos y credenciales de API. Esta guía repasa las API, muestra solicitudes que funcionan y explica la autenticación, según la documentación de Polymarket a octubre de 2026.

Las API de un vistazo

Leer mercados con la API Gamma

La forma más rápida de ver qué se negocia. Esto devuelve los cinco eventos abiertos con más volumen en las últimas 24 horas:

curl "https://gamma-api.polymarket.com/events?active=true&closed=false&order=volume24hr&ascending=false&limit=5"

Cada evento trae sus markets. En cada mercado, outcomePrices es un texto con formato JSON, como ["0.62", "0.38"]: el primer valor es el precio del “Sí”, que también es la probabilidad implícita. Los eventos con muchos candidatos, como una elección, tienen un mercado de sí o no por candidato, con su nombre en groupItemTitle. Otros campos útiles: volume24hr, oneDayPriceChange, endDate y closed.

Para traer un evento por su id numérico:

curl "https://gamma-api.polymarket.com/events/12345"

Rankings y actividad con la API Data

curl "https://data-api.polymarket.com/v1/leaderboard?timePeriod=MONTH&orderBy=PNL&limit=25"

timePeriod acepta DAY, WEEK, MONTH o ALL; orderBy acepta PNL o VOL; un category opcional lo limita a POLITICS, SPORTS o CRYPTO. Lo puedes ver funcionando en nuestro ranking de Polymarket en vivo. El servicio antiguo lb-api.polymarket.com ya no funciona.

Libros de órdenes y precios en vivo

El CLOB entrega precios y libros de órdenes sin autenticación, y el WebSocket de mercado envía los cambios en el momento, lo que es mejor que consultar una y otra vez si necesitas datos en tiempo real. Suscríbete con los token IDs de los resultados que te interesan (están en el campo clobTokenIds de cada mercado en Gamma).

Operar: cómo funciona la autenticación

Enviar órdenes usa dos niveles de autenticación:

1. L1, demostrar que la billetera es tuya. Tu clave firmante firma un mensaje EIP-712 (ClobAuth, en Polygon, chain ID 137) que acredita que controlas la dirección.
2. L2, credenciales de API. Envía esa firma a POST /auth/api-key para crear una clave, un secreto y una frase de acceso, o usa GET /auth/derive-api-key para recuperar las que ya tienes. Desde ahí, cada solicitud privada se firma con HMAC-SHA256 usando el secreto y se envía con los encabezados POLY_API_KEY, POLY_PASSPHRASE, POLY_SIGNATURE, POLY_TIMESTAMP y POLY_ADDRESS.

Las órdenes también las firma la billetera. Polymarket admite varios tipos de billetera: Deposit Wallets (las predeterminadas para cuentas creadas desde el 4 de mayo de 2026), billeteras proxy más antiguas creadas con correo o con Google, billeteras Safe creadas con firmantes tipo MetaMask, y billeteras simples (EOA) autorizadas, que pagan su propio gas en POL. El saldo para operar en el exchange principal es pUSD, respaldado 1 a 1 por USDC.

Reglas y límites

• Las restricciones por país también valen para la API. Los países en modo solo cierre o bloqueados en Polymarket, como Argentina, Venezuela o Brasil (solo cierre) y Estados Unidos para el exchange principal, también están restringidos en la API de trading. Ver la tabla por país. Polymarket US tiene su propia documentación aparte.
• Los límites de solicitudes dependen de tu nivel. Quien la usa mucho puede sumarse al Builder Program de Polymarket para tener límites más altos.
• Comisiones: las órdenes taker pagan comisión en la mayoría de las categorías; las maker no pagan. Ver comisiones.

Preguntas frecuentes

Relacionado: Desarrolladores · Comparar API · API de Kalshi · Ranking de Polymarket · Qué es Polymarket