Polymarket
Consulta los mercados de predicción de Polymarket y comercia desde la terminal. Explora cuotas, investiga eventos, compara mercados, sigue tu cartera, transmite datos en vivo, puentea fondos y ejecuta operaciones, todo a través de lenguaje natural.
Polymarket expone 4 APIs separadas más la capa de conveniencia Gamma. Este skill las cubre todas.
Configuración
Los comandos de solo lectura funcionan de inmediato (sin necesidad de instalación). Navegar, buscar, tendencias, categorías, investigación de mercados y el modo de comparación utilizan la API Gamma pública.
Para trading, libros de órdenes, historial de precios y funciones avanzadas, instala la CLI de Polymarket (binario Rust, v0.1.5+):
brew install polymarket/tap/polymarket-cli
Para trading, configura una billetera:
polymarket wallet create
polymarket approve set
O configura manualmente ~/.config/polymarket/config.json con tu clave privada. Consulta la documentación de la CLI para más detalles.
La CLI también proporciona un REPL interactivo:
polymarket shell
Usa --output json en cualquier comando de la CLI para obtener salida legible por máquina, adecuada para scripts y tuberías.
Comandos
Explorar Mercados (no necesita CLI)
# Mercados en tendencia/activos (ordenados por volumen en 24h)
python3 {baseDir}/scripts/polymarket.py trending
# Tendencias con más resultados
python3 {baseDir}/scripts/polymarket.py trending --limit 20
# Buscar mercados por palabra clave
python3 {baseDir}/scripts/polymarket.py search "trump"
# Obtener un evento específico por slug
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"
# Obtener mercados por categoría
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business
Panel de Mercados en Tendencia (no necesita CLI)
Muestra un panel categorizado de los mercados más activos en Polymarket. Combina tendencias con filtros de categoría para construir una visión general completa.
# Panel de tendencias completo: ejecuta estos en secuencia para construir una imagen:
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5
Cuando el usuario solicite un "panel de control" o "visión general", ejecuta todas las consultas de categoría y presenta los resultados agrupados por sección con encabezados claros. Incluye volumen y cuotas actuales para cada mercado.
Modo de Investigación de Mercados (no necesita CLI)
La investigación de mercados combina las cuotas de Polymarket con análisis contextual. Cuando el usuario solicite "investigar" un mercado o quiera un análisis más profundo más allá de las cuotas:
- Obtén los datos del mercado usando los comandos de búsqueda o evento
- Analiza las cuotas - ¿qué implica el mercado? ¿Hay una ventaja?
- Proporciona contexto - usa tu conocimiento para explicar qué impulsa las cuotas
- Muestra la evolución histórica - si la CLI está disponible, obtén el historial de precios
- Compara con el consenso - ¿cómo se comparan las cuotas de Polymarket con encuestas, opiniones de expertos u otros mercados de predicción?
# Paso 1: Encuentra el mercado
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"
# Paso 2: Obtén datos detallados del evento
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"
# Paso 3: Si la CLI está disponible, obtén el historial de precios para mostrar la tendencia
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d
# Paso 4: Verifica la profundidad del libro de órdenes para evaluar liquidez
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
Después de recopilar datos, sintetiza la investigación en un informe estructurado:
- Cuotas Actuales: Porcentajes de Sí/No y lo que implican
- Volumen y Liquidez: ¿Cuánto dinero hay en este mercado? ¿Es lo suficientemente líquido para operar?
- Tendencia: ¿Las cuotas suben o bajan? ¿Hay picos recientes?
- Contexto: ¿Qué eventos o datos del mundo real están impulsando las cuotas?
- Fechas Clave: ¿Cuándo se resuelve el mercado? ¿Hay próximos catalizadores?
- Factores de Riesgo: ¿Qué podría causar un movimiento repentino?
Modo de Comparación de Mercados (no necesita CLI)
Compara mercados relacionados uno al lado del otro. Útil para encontrar arbitraje, comprender probabilidades condicionales o simplemente ver cómo se relacionan diferentes resultados.
# Compara dos o más mercados relacionados buscando cada uno
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"
Cuando el usuario solicite "comparar mercados" o "cuotas lado a lado":
- Busca cada mercado que el usuario mencione
- Presenta las cuotas en un formato de tabla comparativa
- Nota las diferencias de volumen (mayor volumen = cuotas más fiables)
- Señala cualquier inconsistencia aparente (por ejemplo, probabilidades que deberían sumar ~100% pero no lo hacen)
- Destaca la diferencia entre resultados relacionados
Formatea la comparación como una tabla:
Comparación de Mercados: Elecciones Presidenciales 2028
| Candidato | Sí | Volumen | Liquidez |
|--------------|---------|----------|----------|
| Trump | 32.5% | $4.2M | Alta |
| DeSantis | 18.1% | $1.8M | Media |
| Newsom | 12.4% | $890K | Media |
| Harris | 8.7% | $2.1M | Media |
Panel de Cartera (requiere CLI + billetera)
Visualiza tu cartera completa con posiciones, ganancias/pérdidas y órdenes abiertas en una sola vista.
# Ver todas las posiciones abiertas
python3 {baseDir}/scripts/polymarket.py positions
# Ver posiciones de una billetera específica
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET
# Consultar saldo USDC
python3 {baseDir}/scripts/polymarket.py wallet-balance
# Consultar saldo de un token específico
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID
# Listar todas las órdenes abiertas
python3 {baseDir}/scripts/polymarket.py orders
Cuando el usuario solicite un "panel de cartera" o "cómo voy", ejecuta los tres comandos (positions, wallet-balance, orders) y presenta una vista unificada:
- Posiciones: Cada posición con precio de mercado actual, tu precio de entrada (si está disponible) y P&L no realizado
- Saldo USDC: Efectivo disponible para nuevas operaciones
- Órdenes Abiertas: Órdenes limitadas pendientes con precio y tamaño
- Valor Total de la Cartera: Suma de posiciones + saldo USDC
Libro de Órdenes y Precios (requiere CLI, no necesita billetera)
# Libro de órdenes de un token
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID
# Historial de precios (intervalos: 1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d
# Historial de precios con número específico de puntos de datos
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48
Billetera (requiere CLI)
polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID
Trading (requiere CLI + billetera)
Todas las operaciones requieren --confirm para ejecutarse. Sin él, la orden solo se previsualiza. Esta es una función de seguridad: siempre ves lo que sucederá antes de que suceda.
Transparencia de Costos y Comisiones
Antes de ejecutar cualquier operación, el skill muestra:
- Tipo de orden: Límite o Mercado
- Lado: Compra o Venta
- Precio: Tu precio límite (o "mercado" para órdenes de mercado)
- Tamaño: Número de acciones
- Costo estimado: Precio x Tamaño para órdenes límite, o monto en dólares para órdenes de mercado
- Comisión de Polymarket: Polymarket no cobra comisiones de trading en el CLOB (Libro de Órdenes Límite Central)
- Comisiones de gas: Las operaciones en cadena (aprobaciones, divisiones, canjes) requieren MATIC para gas en Polygon. Gas típico: $0.01-0.05
# Previsualizar una orden límite (sin --confirm = solo previsualización)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10
# Ejecutar una orden límite
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10
# Orden límite de venta
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10
# Orden de mercado: comprar $5 al precio actual
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5
# Orden límite de solo publicación (se mantiene en el libro, nunca toma liquidez - Ene 2026+)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only
Órdenes y Posiciones (requiere CLI + billetera)
# Listar órdenes abiertas
python3 {baseDir}/scripts/polymarket.py orders
# Cancelar una orden específica
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID
# Cancelar todas las órdenes
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all
# Ver posiciones
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET
Referencia de API
Polymarket expone 4 APIs distintas más la capa de conveniencia Gamma. Cada una sirve un propósito diferente.
1. API Gamma (gamma-api.polymarket.com) - Pública, sin autenticación
La API de conveniencia de alto nivel para navegar y buscar mercados. Utilizada por todos los comandos de solo lectura.
- URL base:
https://gamma-api.polymarket.com GET /events- Listar eventos (parámetros:order,ascending,closed,limit,tag_slug)GET /search- Buscar mercados (parámetros:query,limit)GET /events/slug/{slug}- Evento por slugGET /comments- Listar y filtrar comentarios en mercadosGET /profiles/{address}- Perfiles de usuario públicosGET /series- Colecciones de eventos agrupados (por ejemplo, serie "Elecciones 2028")GET /sports- Metadatos deportivos que incluyen equipos, partidos y criterios de resolución- GraphQL:
POST /query- Punto final GraphQL completo con soporte de suscripción
2. API CLOB (clob.polymarket.com) - Trading
La API del Libro de Órdenes Límite Central para todas las operaciones de trading. Envueltas por la CLI de Polymarket.
- URL base:
https://clob.polymarket.com GET /prices-history- Precios históricos (intervalos:1m,1h,6h,1d,1w,max)GET /spread- Diferencial de oferta/demanda para un tokenGET /fee-rate- Detalles de la estructura de comisionesGET /rewards- Ganancias diarias de creador/tomadorPOST /order- Colocar una ordenPOST /orders- Órdenes por lotes (hasta 15 por solicitud)DELETE /order/{id}- Cancelar una orden- Puntuación de órdenes - Verificar elegibilidad de reembolso de creador antes de colocar órdenes
- Órdenes de solo publicación (Ene 2026) - Órdenes que solo se mantienen en el libro, nunca cruzan el diferencial
- API de latido (Ene 2026):
POST /heartbeat- Debe enviarse dentro de los 10 segundos o todas las órdenes abiertas se cancelan automáticamente- Utilizado por creadores de mercado para mantener la presencia de órdenes
- Si el latido falla, todas las órdenes en reposo para esa clave de API se cancelan
3. API de Datos (data-api.polymarket.com) - Cartera y Analítica
La API dedicada para el seguimiento de carteras, historial de operaciones y análisis de mercado. No necesita autenticación para puntos finales públicos.
- URL base:
https://data-api.polymarket.com GET /positions?user={address}- Posiciones abiertas actuales- Ordenar por:
TOKENS,CURRENT,INITIAL,CASHPNL,PERCENTPNL
- Ordenar por:
GET /closed-positions?user={address}- Posiciones cerradas históricasGET /activity?user={address}- Feed de actividad- Tipos:
TRADE,SPLIT,MERGE,REDEEM,REWARD
- Tipos:
GET /value?user={address}- Valoración de cartera en USDGET /trades- Historial de operaciones- Filtrar por:
user,market,side - Máximo 500 resultados por página
- Filtrar por:
GET /holders?market={conditionId}- Principales tenedores de tokens para un mercadoGET /oi- Interés abierto en todos los mercadosGET /volume- Volumen de trading en todos los mercadosGET /leaderboard- Rankings de traders (período de tiempo configurable)
Utiliza la API de Datos para paneles de cartera y análisis. Proporciona datos de posición más ricos que la API CLOB, incluidos cálculos de P&L e historial de actividad.
4. WebSocket RTDS (wss://ws-live-data.polymarket.com) - Transmisión en Tiempo Real
Transmisión de datos en tiempo real a través de WebSocket. Suscríbete a temas para obtener actualizaciones en vivo sin sondeo.
- URL:
wss://ws-live-data.polymarket.com - Protocolo: Mensajes JSON a través de WebSocket
- Temas:
comments- Actividad de comentarios en tiempo real- Eventos:
comment_created,comment_removed,reaction_created,reaction_removed
- Eventos:
crypto_prices- Precios de criptomonedas en tiempo real- Activos: BTC, ETH, SOL, XRP
- Fuentes: oráculos de Binance + Chainlink
- Gestión dinámica de suscripciones - Suscríbete y cancela suscripciones a temas sobre la marcha dentro de una sola conexión
- Útil para construir paneles en vivo, monitorear el sentimiento de los comentarios o rastrear precios de cripto que alimentan mercados de cripto de 5 minutos
5. API Bridge (bridge.polymarket.com) - Depósitos y Retiros entre Cadenas
Puentea fondos hacia y desde Polymarket a través de múltiples cadenas.
- URL base:
https://bridge.polymarket.com POST /deposit- Generar direcciones de depósito- Cadenas compatibles: EVM (Ethereum, Polygon, Arbitrum, etc.), Solana, Bitcoin
- Devuelve una dirección de depósito única para la cadena seleccionada
POST /withdraw(Ene 2026) - Puentear USDC.e a cualquier cadena compatibleGET /supported-assets- Listar todos los activos y cadenas compatiblesGET /quote- Obtener cotizaciones de puente entre cadenas (comisiones, tiempo estimado)
Utiliza la API Bridge cuando un usuario necesite mover fondos dentro o fuera de Polymarket sin salir de la terminal.
Nuevos Tipos de Mercado
- Mercados de cripto de 5 minutos (Feb 2026) - Mercados de duración ultra corta sobre movimientos de precio de BTC/ETH/SOL. Alimentados por los datos de crypto_prices de RTDS.
- Mercados deportivos - Metadatos deportivos dedicados a través del punto final Gamma
/sportscon información de equipos, calendarios de partidos y criterios de resolución.
Recuperación de Errores
Errores de API (API Gamma)
Si la API Gamma devuelve un error o no está disponible:
- HTTP 429 (Límite de velocidad): Espera 5 segundos y vuelve a intentarlo. Si el error persiste, reducelimitando el número de resultados (por ejemplo,
--limit 5). - HTTP 503 / Tiempo de espera agotado: API Gamma puede estar sobrecargada. Vuelve a intentarlo con una red de respaldo. Vuelve a intentar la solicitud después de 10 segundos. Si falla de nuevo, informa al usuario que el servicio no está disponible temporalmente.
- Error de JSON: La API puede devolver HTML durante el mantenimiento. Vuelve a intentarlo en 30 segundos.
- No se encontraron resultados: Esto es normal para eventos futuros. No es un error. Informa al usuario que no hay mercados coincidentes y sugiere términos de búsqueda alternativos.