Communitygithub.com

mvanhorn/clawdbot-skill-polymarket

Mercados de predicción de Polymarket al alcance de tu mano: consulta cuotas, sigue carteras, investiga mercados con análisis impulsado por IA, compara mercados y comercia. Cubre las 4 APIs de Polymarket: Gamma, CLOB, Data API, RTDS WebSocket y Bridge. El modo solo lectura funciona al instante (sin configuración). El skill de mercados de predicción más completo en ClawHub.

¿Qué es clawdbot-skill-polymarket?

Este skill permite a los agentes de IA interactuar con Polymarket, el principal mercado de predicción descentralizado, directamente desde la terminal. Proporciona acceso completo a las cuatro APIs de Polymarket (Gamma, CLOB, Data API y RTDS WebSocket) y a su capa Bridge, permitiendo desde consultas de solo lectura (como explorar mercados, buscar eventos y obtener cuotas) hasta operaciones avanzadas como trading de órdenes límite y de mercado, gestión de carteras, visualización de libros de órdenes y streaming de datos en tiempo real. El modo solo lectura funciona sin configuración previa, mientras que para trading se requiere instalar la CLI de Polymarket y configurar una billetera. El skill está diseñado para ofrecer máxima flexibilidad: los comandos de solo lectura usan la API Gamma pública, mientras que las funciones de trading y datos históricos aprovechan la CLI de Rust. Además, incluye modos especializados como 'Investigación de Mercados' (que combina cuotas con análisis contextual) y 'Comparación de Mercados' (para ver odds lado a lado), así como paneles de control para carteras y tendencias. Soporta todos los tipos de mercados, incluyendo los nuevos mercados de cripto de 5 minutos y mercados deportivos.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add mvanhorn/clawdbot-skill-polymarket

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Obtén los datos del mercado usando los comandos de búsqueda o evento
  2. Analiza las cuotas - ¿qué implica el mercado? ¿Hay una ventaja?
  3. Proporciona contexto - usa tu conocimiento para explicar qué impulsa las cuotas
  4. Muestra la evolución histórica - si la CLI está disponible, obtén el historial de precios
  5. 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":

  1. Busca cada mercado que el usuario mencione
  2. Presenta las cuotas en un formato de tabla comparativa
  3. Nota las diferencias de volumen (mayor volumen = cuotas más fiables)
  4. Señala cualquier inconsistencia aparente (por ejemplo, probabilidades que deberían sumar ~100% pero no lo hacen)
  5. 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 slug
  • GET /comments - Listar y filtrar comentarios en mercados
  • GET /profiles/{address} - Perfiles de usuario públicos
  • GET /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 token
  • GET /fee-rate - Detalles de la estructura de comisiones
  • GET /rewards - Ganancias diarias de creador/tomador
  • POST /order - Colocar una orden
  • POST /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
  • GET /closed-positions?user={address} - Posiciones cerradas históricas
  • GET /activity?user={address} - Feed de actividad
    • Tipos: TRADE, SPLIT, MERGE, REDEEM, REWARD
  • GET /value?user={address} - Valoración de cartera en USD
  • GET /trades - Historial de operaciones
    • Filtrar por: user, market, side
    • Máximo 500 resultados por página
  • GET /holders?market={conditionId} - Principales tenedores de tokens para un mercado
  • GET /oi - Interés abierto en todos los mercados
  • GET /volume - Volumen de trading en todos los mercados
  • GET /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
    • 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 compatible
  • GET /supported-assets - Listar todos los activos y cadenas compatibles
  • GET /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 /sports con 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.

Skills relacionados