helebest/holo-polymarket

Consulta Polymarket

Un skill de solo lectura para investigar mercados de predicción de Polymarket (nunca coloca órdenes). Cubre dos necesidades:

• Investigación de mercados: eventos populares, búsqueda, detalle de eventos, precio histórico y tendencias de probabilidad/volumen.
• Seguimiento de posiciones y ballenas: tabla de líderes, posiciones y P&L de cualquier dirección, e historial de trades.

Para comprar/vender realmente (colocar órdenes, cancelar, consultar saldos, gestión de órdenes), usa el skill polymarket-trade.

Inicio rápido

1. Verifica el entorno: bash, curl, jq y acceso a gamma-api.polymarket.com / data-api.polymarket.com / clob.polymarket.com.
2. Elige un tipo de tarea: información de mercado / ballenas y posiciones / tendencias históricas.
3. Ejecuta el comando correspondiente: bash <directorio-del-skill>/scripts/polymarket.sh <comando> [argumentos...].

Lista completa de comandos: references/commands.md. Solución de problemas: references/troubleshooting.md.

Elegir un comando

• Mercados populares rápidos: hot [límite].
• Buscar mercados por palabra clave: search <palabraclave> [límite].
• Inspeccionar un evento por slug (con tokens): detail <slug-del-evento>.
• Rastrear los mejores traders / consultar posiciones: leaderboard (alias lb) → positions (alias pos) → trades.
  • Solo posiciones abiertas: positions <dirección> [límite] --active.
  • Tu propia wallet: con POLYMARKET_FUNDER (o FUNDER) configurado, positions / trades usan esa dirección por defecto cuando no se proporciona una. Usa la dirección de tu wallet proxy (la que tiene fondos/posiciones), no la de firmante/EOA.
• Revisión de series temporales:
  • Tabla de probabilidades: history
  • Resumen de cambio inicio/fin: trend
  • Cambios de volumen: volume-trend
• Exportación a archivo: agrega --format csv|json y opcionalmente --out <archivo> a history/trend/volume-trend.

Ejemplos mínimos

# 1) Mercados populares
bash <directorio-del-skill>/scripts/polymarket.sh hot 5

# 2) Búsqueda + detalle
bash <directorio-del-skill>/scripts/polymarket.sh search bitcoin 5
bash <directorio-del-skill>/scripts/polymarket.sh detail fed-decision-in-march-885

# 3) Seguimiento de ballenas y posiciones
bash <directorio-del-skill>/scripts/polymarket.sh lb 10 pnl week
bash <directorio-del-skill>/scripts/polymarket.sh pos 0xc257ea... 10
bash <directorio-del-skill>/scripts/polymarket.sh pos 0xc257ea... 10 --active   # solo abiertas
bash <directorio-del-skill>/scripts/polymarket.sh trades 0xc257ea... 10

# 4) Tendencias históricas + exportación
bash <directorio-del-skill>/scripts/polymarket.sh history fed-decision-in-march-885 2025-01-01 2025-01-31 1d
bash <directorio-del-skill>/scripts/polymarket.sh trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format csv
bash <directorio-del-skill>/scripts/polymarket.sh volume-trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format json --out /tmp/volume.json

Reglas de parámetros: desde/hasta son YYYY-MM-DD; intervalo es 1h / 4h / 1d.

Fallos comunes

• Dependencias faltantes: instala curl / jq.
• Fallos de red: verifica la accesibilidad de la API y los tiempos de espera; aumenta CURL_TIMEOUT si es necesario. En un entorno proxy, HTTPS_PROXY se detecta automáticamente.
• Fallos de precio histórico: verifica POLYMARKET_BEARER_TOKEN o un archivo de credenciales (ver abajo).
• Errores de argumentos: vuelve a verificar el uso del comando y el formato de fecha (YYYY-MM-DD).

Credenciales (solo el endpoint de precio histórico las necesita)

El endpoint de precio histórico puede requerir un token Bearer. Se resuelve en este orden (neutral para el agente, no vinculado a ningún runtime):

1. Variable de entorno POLYMARKET_BEARER_TOKEN
2. El archivo nombrado por POLYMARKET_CREDENTIALS_FILE
3. ./.credentials en el directorio del proyecto (debe estar en gitignore)
4. ~/.config/holo-polymarket/credentials
5. ~/.openclaw/credentials/polymarket_credentials (respaldo heredado)

El archivo de credenciales es de tipo CLAVE=VALOR y admite los campos BEARER_TOKEN / TOKEN.

El mismo archivo (o variable de entorno) puede proporcionar también POLYMARKET_FUNDER / FUNDER — la dirección de tu wallet proxy. Cuando está configurada, positions / trades la usan por defecto si no se proporciona una dirección en la línea de comandos. Esta es la única identidad que lee el skill de consulta; todo lo demás aquí es de solo lectura y público.

Límite de trading

Este skill es de solo lectura y nunca coloca órdenes. Para comprar/vender, cancelar, consultar saldos y gestión de órdenes, usa el skill polymarket-trade (basado en la API CLOB oficial).