Resumen
Polymarket CLI es una herramienta de línea de comandos basada en Rust que te permite explorar mercados de predicción, realizar pedidos, gestionar posiciones e interactuar con contratos en cadena directamente desde tu terminal. Instálalo a través de Homebrew o un script de shell, navega por los mercados sin una billetera y opera utilizando la salida JSON para la automatización. Requiere una clave privada para las operaciones de trading. Admite formatos de salida de tabla y JSON tanto para uso legible por humanos como programático.
Introducción
Los mercados de predicción han surgido como herramientas poderosas para pronosticar eventos del mundo real, desde resultados electorales hasta movimientos de precios de criptomonedas. Polymarket, construido sobre Polygon, ofrece uno de los mercados de predicción más líquidos con millones en volumen de operaciones. Si bien la interfaz web es intuitiva, los desarrolladores a menudo desean acceso programático para la automatización, la creación de scripts y la construcción de bots de trading personalizados.
Ahí es donde entra Polymarket CLI. Esta herramienta de línea de comandos basada en Rust proporciona acceso completo al ecosistema de Polymarket desde tu terminal. Ya sea que desees explorar mercados, analizar libros de órdenes o ejecutar operaciones automáticamente, Polymarket CLI ofrece una interfaz robusta que se integra perfectamente con scripts de shell y flujos de trabajo de automatización.
¿Qué es Polymarket?
Polymarket es una plataforma descentralizada de mercados de predicción construida sobre la cadena de bloques Polygon. Permite a los usuarios operar con los resultados de eventos del mundo real utilizando la stablecoin USDC. Los mercados se estructuran como preguntas de sí/no, con precios que representan la probabilidad de un resultado (por ejemplo, 52¢ significa 52% de probabilidad).
Las características clave de Polymarket incluyen:
- Trading descentralizado: Construido sobre Polygon para transacciones rápidas y de bajo costo.
- Mercados en tiempo real: Miles de mercados que cubren política, criptomonedas, deportes y más.
- Modelo de libro de órdenes: Libro de órdenes de límite central (CLOB) para el descubrimiento de precios.
- Tokens condicionales: Tokens ERC-1155 que representan participaciones de resultados.
- Programa de recompensas: Los traders pueden ganar recompensas basadas en el volumen de trading.
Polymarket CLI se conecta a estos mercados a través de una combinación de APIs fuera de la cadena (para leer datos de mercado y realizar pedidos) y contratos en cadena (para operaciones de tokens como dividir, fusionar y canjear).
Instalación de Polymarket CLI
Polymarket CLI admite varios métodos de instalación. Elige el que mejor se adapte a tu entorno.
Opción 1: Homebrew (macOS / Linux)
El método de instalación más sencillo utiliza Homebrew:
# Agrega el tap de Polymarket
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
# Instala polymarket
brew install polymarket
Opción 2: Script de Shell (Linux/macOS)
Para una instalación rápida de una sola línea:
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
Esto descarga el binario más reciente y lo instala en tu PATH.
Opción 3: Compilar desde el código fuente (Todas las plataformas)
Si tienes Rust instalado, puedes compilar desde el código fuente:
git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .
Verificación de la instalación
Verifica que la instalación haya sido exitosa:
polymarket --version
polymarket --help
Deberías ver la información de la versión y un mensaje de ayuda con los comandos disponibles.
Inicio rápido: Navegar por los mercados sin una billetera
Una de las mejores características de Polymarket CLI es que no necesitas una billetera para navegar por los mercados. Esto lo hace perfecto para la investigación y el monitoreo antes de comprometer fondos.
Navegar por mercados recientes
# Lista los 5 mercados más recientes
polymarket markets list --limit 5
Salida esperada:
Buscar mercados específicos
# Busca mercados relacionados con Bitcoin
polymarket markets search "bitcoin" --limit 5
Filtrar por estado y volumen
# Lista mercados cerrados
polymarket markets list --closed true --limit 20
Navegar por eventos
Los eventos agrupan mercados relacionados. Por ejemplo, el evento "Elecciones 2024" contiene múltiples mercados sobre diferentes aspectos de las elecciones.
# Lista eventos recientes
polymarket events list --limit 10
# Filtra eventos por etiqueta
polymarket events list --tag politics --active true
# Obtén un evento específico
polymarket events get 500
Configuración y ajuste de la billetera
Mientras que la navegación no requiere una billetera, el trading sí. Aquí te explicamos cómo configurar tu billetera.
Creación de una nueva billetera
# Crea una nueva billetera (genera clave aleatoria, guarda en config)
polymarket wallet create
Esto genera una nueva clave privada y la almacena en tu archivo de configuración en ~/.config/polymarket/config.json.
Importar una billetera existente
Si ya tienes una billetera con fondos:
polymarket wallet import 0xTU_CLAVE_PRIVADA_AQUÍ
Ubicación del archivo de configuración
El archivo de configuración se almacena en ~/.config/polymarket/config.json y tiene el siguiente aspecto:
{
"private_key": "0xabc123...",
"chain_id": 137,
"signature_type": "proxy"
}
Métodos de configuración de la billetera
Puedes proporcionar tu clave privada de tres maneras (verificadas en este orden):
- Bandera CLI:
--private-key 0xabc... - Variable de entorno:
POLYMARKET_PRIVATE_KEY=0xabc... - Archivo de configuración:
~/.config/polymarket/config.json
Tipos de firma
Polymarket admite tres tipos de firma:
| Tipo | Descripción |
|---|---|
proxy (predeterminado) | Utiliza el sistema de billetera proxy de Polymarket |
eoa | Firma directamente con tu clave |
gnosis-safe | Para billeteras multifirma (multisig) |
Anula por comando con --signature-type eoa.
Verificación del estado de la billetera
# Muestra la información completa de la billetera
polymarket wallet show
# Imprime solo la dirección
polymarket wallet address
Aprobaciones de contratos
Antes de operar, necesitas aprobar los contratos de Polymarket:
# Verifica las aprobaciones actuales (solo lectura)
polymarket approve check
# Aprueba todos los contratos (envía 6 transacciones en cadena)
polymarket approve set
Nota: La aprobación de contratos requiere MATIC para las tarifas de gas en Polygon.
Explorando mercados y eventos
Profundicemos en los comandos de exploración del mercado.
Comandos de mercado
# Obtén información detallada del mercado
polymarket markets get will-bitcoin-hit-100k
# Obtén las etiquetas para un mercado
polymarket markets tags ID_DEL_MERCADO
# Lista mercados con varios filtros
polymarket markets list \
--active true \
--order volume_num \
--limit 20 \
--offset 10
Comandos de evento
# Lista eventos con filtros
polymarket events list --active true --limit 10
# Obtén etiquetas de eventos
polymarket events tags ID_DEL_EVENTO
# Series (eventos recurrentes como mercados semanales)
polymarket series list --limit 10
polymarket series get ID_DE_LA_SERIE
Comandos de etiquetas
# Lista todas las etiquetas
polymarket tags list
# Obtén información específica de una etiqueta
polymarket tags get politics
# Encuentra etiquetas relacionadas
polymarket tags related politics
Comandos CLOB (Libro de órdenes)
Verifica precios y libros de órdenes sin una billetera:
# Verifica el estado de la API
polymarket clob ok
# Obtén el precio de un token
polymarket clob price ID_DEL_TOKEN --side buy
polymarket clob midpoint ID_DEL_TOKEN
# Obtén el diferencial (spread)
polymarket clob spread ID_DEL_TOKEN
# Obtén el libro de órdenes
polymarket clob book ID_DEL_TOKEN
# Último precio de operación
polymarket clob last-trade ID_DEL_TOKEN
# Historial de precios
polymarket clob price-history ID_DEL_TOKEN --interval 1d --fidelity 30
Opciones de intervalo: 1m, 1h, 6h, 1d, 1w, max
Operando en Polymarket
Ahora, la parte emocionante: realizar operaciones. Estos comandos requieren una billetera configurada.
Realizando órdenes
# Realiza una orden límite (compra 10 acciones a $0.50)
polymarket clob create-order \
--token ID_DEL_TOKEN \
--side buy \
--price 0.50 \
--size 10
# Realiza una orden de mercado (compra por valor de $5)
polymarket clob market-order \
--token ID_DEL_TOKEN \
--side buy \
--amount 5
# Publica múltiples órdenes a la vez
polymarket clob post-orders \
--tokens "TOKEN1,TOKEN2" \
--side buy \
--prices "0.40,0.60" \
--sizes "10,10"
Tipos de orden: GTC (Good Till Cancel - predeterminado), FOK (Fill or Kill), GTD (Good Till Date), FAK (Fill and Kill)
Agrega --post-only para órdenes límite que solo agregan liquidez.
Gestionando órdenes
# Ve tus órdenes
polymarket clob orders
# Obtén detalles específicos de una orden
polymarket clob order ID_DE_LA_ORDEN
# Cancela una sola orden
polymarket clob cancel ID_DE_LA_ORDEN
# Cancela múltiples órdenes
polymarket clob cancel-orders "ORDEN1,ORDEN2"
# Cancela todas las órdenes para un mercado
polymarket clob cancel-market --market ID_DE_LA_CONDICIÓN
# Cancela todas las órdenes
polymarket clob cancel-all
Verificando saldos y operaciones
# Verifica el saldo de USDC
polymarket clob balance --asset-type collateral
# Verifica el saldo de tokens condicionales
polymarket clob balance --asset-type conditional --token ID_DEL_TOKEN
# Ve tus operaciones
polymarket clob trades
# Actualiza el saldo (actualiza desde la cadena)
polymarket clob update-balance --asset-type collateral
Recompensas y Claves API
# Verifica las recompensas
polymarket clob rewards --date 2024-06-15
polymarket clob current-rewards
# Verifica si las órdenes están acumulando recompensas
polymarket clob order-scoring ID_DE_LA_ORDEN
# Crea una clave API para acceso programático
polymarket clob create-api-key
# Lista tus claves API
polymarket clob api-keys
Operaciones en cadena
Polymarket CLI también admite la interacción directa con contratos en cadena.
Operaciones CTF (Marco de Tokens Condicionales)
# Divide $10 USDC en tokens SÍ/NO
polymarket ctf split --condition ID_DE_LA_CONDICIÓN --amount 10
# Fusiona tokens de nuevo a USDC
polymarket ctf merge --condition ID_DE_LA_CONDICIÓN --amount 10
# Canjea tokens ganadores después de la resolución
polymarket ctf redeem --condition ID_DE_LA_CONDICIÓN
Nota: Las operaciones en cadena requieren MATIC para el gas en Polygon.
Operaciones de puente
Deposita activos de otras cadenas:
# Obtén direcciones de depósito para EVM, Solana, Bitcoin
polymarket bridge deposit TU_DIRECCIÓN_DE_POLYGON
# Lista cadenas y tokens admitidos
polymarket bridge supported-assets
# Verifica el estado del depósito
polymarket bridge status DIRECCIÓN_DE_DEPÓSITO
Datos del portafolio
# Ve las posiciones actuales
polymarket data positions TU_DIRECCIÓN_DE_BILLETERA
# Ve las posiciones cerradas
polymarket data closed-positions TU_DIRECCIÓN_DE_BILLETERA
# Valor total del portafolio
polymarket data value TU_DIRECCIÓN_DE_BILLETERA
# Historial de operaciones
polymarket data trades TU_DIRECCIÓN_DE_BILLETERA --limit 50
Usando la salida JSON para scripts
Una de las características más potentes de Polymarket CLI es la salida JSON, lo que la hace perfecta para scripting y automatización.
Salida JSON básica
# Obtén mercados en formato JSON
polymarket -o json markets list --limit 10
Salida:
[
{"id": "12345", "question": "¿Llegará BTC a $100k?", "outcomePrices": ["0.67", "0.33"], ...},
{"id": "67890", "question": "¿Superará ETH a BTC?", "outcomePrices": ["0.12", "0.88"], ...}
]
Usando con jq
# Extrae solo las preguntas
polymarket -o json markets list --limit 100 | jq '.[].question'
# Obtén datos de precios específicos
polymarket -o json clob midpoint ID_DEL_TOKEN | jq '.mid'
# Filtra mercados por volumen
polymarket -o json markets list --limit 100 | jq '.[] | select(.volume_num > 1000000)'
Manejo de errores en scripts
#!/bin/bash
# Ejemplo: Verifica el saldo con manejo de errores
if ! result=$(polymarket -o json clob balance --asset-type collateral 2>/dev/null); then
echo "Fallo al obtener el saldo"
exit 1
fi
balance=$(echo "$result" | jq -r '.balance')
echo "Tu saldo: $balance USDC"
Automatizando el monitoreo de mercados
Crea un monitor de mercado simple:
#!/bin/bash
# monitor-market.sh - Monitorea el precio de un mercado específico
ID_DEL_TOKEN=$1
INTERVALO=${2:-60} # Predeterminado 60 segundos
while true; do
clear
echo "Monitoreando mercado: $(date)"
polymarket clob price $ID_DEL_TOKEN --side buy
polymarket clob price $ID_DEL_TOKEN --side sell
echo ""
polymarket clob book $ID_DEL_TOKEN | head -20
sleep $INTERVALO
done
Ejecútalo con: ./monitor-market.sh ID_DEL_TOKEN 30
Probando la API de Polymarket con Apidog
Al construir sistemas de trading automatizados o integrar Polymarket en tus aplicaciones, la prueba exhaustiva de la API es esencial. Apidog proporciona una plataforma de desarrollo de API potente y todo en uno que hace que probar las APIs de los mercados de predicción sea sencillo y eficiente.
¿Por qué usar Apidog para la integración con Polymarket?
Ya sea que estés construyendo un bot de trading, un panel de análisis de mercado o integrando datos de Polymarket en tu aplicación, Apidog ofrece varias ventajas:
- Cliente visual de API: Envía solicitudes e inspecciona respuestas sin escribir código.
- Pruebas automatizadas: Crea suites de pruebas para verificar tu lógica de trading.
- Variables de entorno: Gestiona puntos finales de API y credenciales en entornos de desarrollo/staging/producción.
- Colaboración: Comparte definiciones de API con tu equipo.
Modo interactivo de shell
Para la exploración interactiva, usa el shell integrado:
polymarket shell
Esto abre un REPL interactivo:
polymarket> markets list --limit 3
polymarket> clob book ID_DEL_TOKEN
polymarket> exit
El shell admite el historial de comandos, lo que facilita la experimentación con diferentes comandos.
Flujos de trabajo comunes
Flujo de trabajo 1: Investigación y comercio
# Paso 1: Encuentra mercados interesantes
polymarket markets search "bitcoin" --limit 10
polymarket markets get bitcoin-above-100k
# Paso 2: Verifica el libro de órdenes y los precios
polymarket clob book ID_DEL_TOKEN
polymarket clob price-history ID_DEL_TOKEN --interval 1d
# Paso 3: Verifica tu saldo
polymarket clob balance --asset-type collateral
# Paso 4: Realiza una operación
polymarket clob market-order --token ID_DEL_TOKEN --side buy --amount 10
Flujo de trabajo 2: Gestión de portafolio
# Ve todas las posiciones
polymarket data positions TU_DIRECCIÓN
# Verifica el valor total
polymarket data value TU_DIRECCIÓN
# Ve el historial de trading
polymarket data trades TU_DIRECCIÓN --limit 50
# Verifica las órdenes abiertas
polymarket clob orders
Flujo de trabajo 3: Bot de trading programático
#!/bin/bash
# Bot simple: compra cuando el precio cae por debajo del umbral
ID_DEL_TOKEN="TU_ID_DEL_TOKEN"
UMBRAL=0.45
CANTIDAD=10
# Obtén el precio actual
PRECIO=$(polymarket -o json clob midpoint $ID_DEL_TOKEN | jq -r '.mid')
# Convierte a decimal
PRECIO_DECIMAL=$(echo "scale=2; $PRECIO / 100" | bc)
if (( $(echo "$PRECIO_DECIMAL < $UMBRAL" | bc -l) )); then
echo "El precio ($PRECIO_DECIMAL) está por debajo del umbral ($UMBRAL) - comprando"
polymarket clob market-order --token $ID_DEL_TOKEN --side buy --amount $CANTIDAD
else
echo "El precio ($PRECIO_DECIMAL) está por encima del umbral - manteniendo"
fi
Consideraciones de seguridad
Al usar Polymarket CLI, ten en cuenta estas mejores prácticas de seguridad:
Seguridad de la clave privada
- Nunca comprometas tu clave privada al control de versiones.
- Usa el archivo de configuración en lugar de variables de entorno en entornos compartidos.
- Considera la integración con billeteras de hardware para grandes fondos.
- Usa una billetera separada para el trading con CLI (no tu billetera principal).
Verificación de transacciones
- Siempre verifica los detalles de la transacción antes de confirmar.
- Comienza con pequeñas cantidades para probar tu configuración.
- Mantén tu saldo de MATIC suficiente para las tarifas de gas.
Gestión de claves API
# Crea claves API dedicadas para scripts
polymarket clob create-api-key
# Lista y gestiona claves
polymarket clob api-keys
# Elimina claves comprometidas
polymarket clob delete-api-key
Seguridad de la red
- Usa la CLI sobre HTTPS (predeterminado).
- Ten precaución al usar claves privadas en entornos de nube.
- Considera usar una VPN al operar desde redes públicas.
Conclusión
Polymarket CLI es una herramienta poderosa para desarrolladores que desean interactuar con los mercados de predicción de forma programática. Ya seas un trader que busca automatizar estrategias, un investigador que analiza datos de mercado o un desarrollador que construye bots de trading, la CLI proporciona una interfaz robusta para el ecosistema de Polymarket.
Puntos clave de esta guía:
- Instala a través de Homebrew o un script de shell para una configuración rápida.
- Navega por los mercados sin una billetera para investigación.
- Configura tu billetera correctamente antes de operar.
- Usa la salida JSON para scripting y automatización.
- Siempre prioriza la seguridad al manejar claves privadas.
- Comienza con pequeñas operaciones para probar tu configuración.
- Usa Apidog para probar y validar tus integraciones de la API de Polymarket.
Para casos de uso más avanzados, considera combinar Polymarket CLI con otras herramientas como cron para tareas programadas, jq para procesamiento de datos o bots personalizados construidos en Python o Node.js. Al construir tu integración de trading, usa Apidog para probar a fondo todos los puntos finales de la API antes de salir en vivo.
Prueba Apidog gratis para agilizar tu flujo de trabajo de prueba de API y generar confianza en tus integraciones de Polymarket.
Preguntas frecuentes
¿Es seguro usar Polymarket CLI?
Polymarket CLI es un software experimental. Úsalo con precaución y nunca lo uses con grandes cantidades de fondos. Siempre verifica las transacciones antes de confirmar. El proyecto es de código abierto, por lo que puedes revisar el código tú mismo.
¿Necesito una billetera para navegar por los mercados?
No. La mayoría de los comandos (mercados, eventos, precios CLOB, libros de órdenes) funcionan sin una billetera. Solo necesitas una billetera para realizar órdenes, verificar saldos y operaciones en cadena.
¿Qué cadenas admite Polymarket?
Polymarket está construido sobre Polygon (ID de cadena 137). La CLI maneja tanto operaciones en cadena (que requieren MATIC para el gas) como la colocación de órdenes fuera de cadena.
¿Puedo usar Polymarket CLI para el trading automatizado?
Sí. El formato de salida JSON lo hace ideal para scripting. Puedes construir bots de trading automatizados usando scripts de shell, Python o cualquier lenguaje que pueda ejecutar comandos CLI y analizar JSON.
¿Cómo obtengo ayuda con Polymarket CLI?
Consulta el repositorio oficial de GitHub para documentación y seguimiento de problemas.
¿Polymarket CLI admite testnet?
La versión actual funciona con la implementación principal de Polymarket. Para soporte de testnet, consulta el repositorio de GitHub para obtener la información más reciente.
¿Cuál es la diferencia entre los tipos de firma proxy y eoa?
proxy (predeterminado) utiliza el sistema de billetera proxy de Polymarket, lo que puede reducir los costos de gas. eoa firma directamente con tu clave privada. Para la mayoría de los usuarios, se recomienda el tipo proxy predeterminado.
¿Cómo actualizo Polymarket CLI a la última versión?
Ejecuta polymarket upgrade para buscar e instalar actualizaciones. Para instalaciones de Homebrew, usa brew update && brew upgrade polymarket.
¿Puedo usar Apidog para probar las llamadas a la API de Polymarket?
Sí. Apidog es una excelente herramienta para probar las APIs de los mercados de predicción. Crea un nuevo proyecto en Apidog, agrega tus puntos finales de Polymarket y usa el cliente visual para enviar solicitudes e inspeccionar respuestas. Las variables de entorno de Apidog facilitan la gestión de diferentes credenciales de API, y puedes crear escenarios de prueba automatizados para verificar que tu lógica de trading funcione correctamente.