Guía Cuant para Polymarket CLOB: Despliega un bot de copia de ballenas y maker con 0% de comisiones usando py-clob-client
Recorrido de ingeniería completo: deriva credenciales L2 de Polygon CLOB, consulta IDs de tokens de condición Gamma, suscríbete a las ejecuciones de ballenas y coloca órdenes límite sin gas con 0% de comisiones EIP-712.
lista de verificación de 3 minutos para principiantes
- ✓Equipo de computadora Windows/Mac o un VPS de Ubuntu de $5/mes con Python 3.10+ instalado
- ✓Una sub-bolsa dedicada en la Billetera Web3 de OKX o MetaMask (nunca uses tu billetera principal en frío)
- ✓USDC nativo de Polygon valorado entre $50–$200 financiado vía OKX/Binance + ~$1 POL para la aprobación inicial de contrato
¡Nunca ejecutes un bot de trading en vivo en una laptop doméstica que entre en reposo o pierda Wi-Fi! recomendamos RAKsmart Cloud VPS: (1) Elige Tokio, Singapur o Silicon Valley para una latencia ultra baja en milisegundos con OKX/Binance y RPCs de Polygon; (2) Selecciona Ubuntu 22.04 LTS (2 vCPU / 4GB de RAM) para Docker Compose; (3) Asocia tu dirección IPv4 estática dedicada con la lista blanca de la API de tu bolsa.
¿Acabas de comprar un VPS? Cómo conectar por SSH y ejecutar comandos en Windows / Mac (Guía de 3 minutos)
Muchos usuarios por primera vez se atascan justo después de comprar un servidor en la nube: '¿Dónde escribo estos comandos de terminal?'. Sigue estos 5 pasos simples:
• Dirección IPv4 del servidor (ej.,
198.51.100.88Copiar)• Puerto SSH: Generalmente
22Copiar, o un puerto de seguridad personalizado como 22022Copiar / 62134Copiar mostrado en tu panel• Nombre de usuario: Siempre
rootCopiar en Ubuntu• Contraseña de Root: Tu contraseña inicial del servidor
powershellCopiar y pulsa Enter.• En Mac: Presiona Command ⌘ + Space, escribe
TerminalCopiar y pulsa Enter.ssh -p PORT root@SERVER_IPCopiar (nótese que -pCopiar va en minúscula; si omites un puerto personalizado, recibirás el error Connection refusedCopiar):• Puerto estándar 22:
ssh -p 22 root@198.51.100.88Copiar• Puerto SSH personalizado (p. ej.,
62134Copiar): ssh -p 62134 root@198.51.100.88CopiarAre you sure you want to continue connecting (yes/no)?Copiar, escribe la palabra completa yesCopiar y pulsa Enter.• Pregunta 2 ([!] ¿Por qué el cursor no se mueve cuando escribo mi contraseña?!): Cuando te pida la
password:Copiar, Linux oculta todos los caracteres (ni siquiera aparecen los asteriscos *) por seguridad! Simplemente haz clic derecho en PowerShell (o presiona Cmd + VCopiar en Mac) para pegar tu contraseña de forma invisible y luego pulsa Enter!root@ubuntu:~#Copiar, ¡estás dentro de tu servidor en la nube! Pega estos comandos de configuración una sola vez para instalar Docker, Git y Python:docker compose ...Copiar: Simplemente haz clic derecho para pegar en tu ventana SSH y pulsa Enter.• Para scripts de Python (
.pyCopiar): Escribe nano bot.pyCopiar y pulsa Enter → Haz clic derecho para pegar el código → Presiona Ctrl + O y luego Enter para guardar → Presiona Ctrl + X para salir → Ejecuta nohup python3 bot.py > bot.log 2>&1 &Copiar para que tu bot siga funcionando 24/7 aunque cierres tu laptop!# 1. Update Ubuntu packages and install Git, Curl, and Python3
apt update -y && apt install -y curl git python3-pip python3-venv
# 2. One-line official Docker & Docker Compose installation
curl -fsSL https://get.docker.com | sh && systemctl enable --now docker
# 3. Verify Docker Compose is ready
docker compose version
import os
from py_clob_client.client import ClobClient
from py_clob_client.clob_types import OrderArgs, OrderType
from py_clob_client.order_builder.constants import BUY
# 1. 初始化 Polygon 主网 (chain_id=137) CLOB 客户端
HOST = "https://clob.polymarket.com"
CHAIN_ID = 137
PRIVATE_KEY = os.environ["POLY_PRIVATE_KEY"] # 仅存放于本地 .env,严禁硬编码上传 GitHub
FUNDER_ADDR = os.environ["POLY_PROXY_WALLET"] # Polymarket 代理合约钱包地址
client = ClobClient(HOST, key=PRIVATE_KEY, chain_id=CHAIN_ID, signature_type=1, funder=FUNDER_ADDR)
client.set_api_creds(client.create_or_derive_api_creds())
# 2. 半凯利公式 (Half-Kelly) 动态计算正期望值 (+EV) 下单份额
def compute_half_kelly_shares(bankroll_usdc: float, mkt_price: float, true_prob: float, max_cap: float = 0.15) -> float:
if true_prob <= mkt_price + 0.03: # 要求至少 +3% Alpha 安全边际才出手
return 0.0
full_kelly = (true_prob - mkt_price) / (1.0 - mkt_price)
alloc_pct = min(max_cap, 0.5 * full_kelly)
stake_usdc = bankroll_usdc * alloc_pct
return round(stake_usdc / mkt_price, 2)
# 3. 读取订单簿最优买一价并挂出 0% 手续费 Maker 限价单
TOKEN_ID = "21742633143463906290569050155826241533067272736897614950488156847949938836455"
book = client.get_order_book(TOKEN_ID)
best_bid = float(book.bids[0].price) if book.bids else 0.35
true_p = 0.52 # 来自 JEV / LLM 校准后的真实发生概率
shares = compute_half_kelly_shares(bankroll_usdc=1000.0, mkt_price=best_bid, true_prob=true_p)
if shares >= 5.0:
order_args = OrderArgs(price=best_bid, size=shares, side=BUY, token_id=TOKEN_ID)
signed_order = client.create_order(order_args)
resp = client.post_order(signed_order, OrderType.GTC)
print(f"[CLOB Maker] 挂单成功: price={best_bid:.2f} size={shares} resp={resp}")
explicación línea por línea del código y comandos en español sencillo
| Código / Línea de comandos | Explicación en español sencillo (¿Qué hace esto?) |
|---|---|
from py_clob_client.client import ClobClient
|
Importa el SDK oficial de Python de Polymarket (pip install py-clob-clientCopiar). |
CHAIN_ID = 137
|
137 es el ID de cadena de la red principal de Polygon donde se liquidan todos los contratos USDC de Polymarket. |
PRIVATE_KEY = os.environ["POLY_PRIVATE_KEY"]
|
Lee la clave privada de tu sub-cartera de forma segura desde un archivo local .envCopiar. |
client.create_or_derive_api_creds()
|
Deriva credenciales de la API CLOB L2 sin gas mediante firma EIP-712. |
if true_prob <= mkt_price + 0.03: return 0.0
|
Filtro de seguridad: solo opera si la probabilidad calibrada supera el precio del mercado por al menos +3%. |
alloc_pct = min(max_cap, 0.5 * full_kelly)
|
Aplica el dimensionamiento Half-Kelly con un tope máximo duro del 15% por orden. |
client.post_order(signed_order, OrderType.GTC)
|
Envía una orden pasiva de mercado limit Good-Til-Cancelled con 0% de comisión. |
[!] los 3 errores más comunes de principiantes y guía de solución de problemas
✕ Error común 1: Confundir el Slug de Mercado con TOKEN_IDCopiar
Consulta https://gamma-api.polymarket.com/markets?slug=<slug>Copiar y copia clobTokenIds[0]Copiar para SÍ o clobTokenIds[1]Copiar para NO.
✕ Error común 2: Allowance / Balance not enoughCopiar en el Primer Pedido
Coloca y cancela primero una orden limitada de $1 en la interfaz web de Polymarket para que tu cartera proxy apruebe el gasto de USDC.
✕ error común 3: dejar órdenes límite obsoletas sin vigilancia durante noticias importantes
Cancela y actualiza las cotizaciones en espera de Fabricantes cada 60–90 segundos.
Paso 1: Crear una Sub-Bolsa Dedicada y USDC Nativos en Polygon
Nunca ejecutes scripts automatizados con tu frase semilla principal de almacenamiento en frío. Crea una sub-bolsa aislada, finánciala con USDC nativos de Polygon desde OKX o Binance, y guarda ~$2 en POL para las aprobaciones iniciales.
Paso 2: Derivar Credenciales de la API L2 CLOB Localmente en .envCopiar
Ejecuta client.create_or_derive_api_creds()Copiar una vez para generar tu clave/secret/frase de API L2. Bloquea .envCopiar con chmod 600Copiar y agrégalo a .gitignoreCopiar.
Paso 3: Resolver clobTokenIdsCopiar vía API REST de Gamma
Consulta https://gamma-api.polymarket.com/markets?slug=<market-slug>Copiar para obtener clobTokenIds[0]Copiar (token SÍ) y clobTokenIds[1]Copiar (token NO).
Paso 7: Publicar Órdenes Límite GTC del Maker con Protección contra Cotizaciones Vencidas
Publicar órdenes límite pasivas goza de 0% de comisiones para el Maker y sin deslizamiento de spread. Implementa siempre un latido de 90 segundos que cancele las cotizaciones en espera durante anuncios macroeconómicos importantes.
Headline Quant Guides Directory (With Reading Level, Time & Code Stack)
Start from L1 Beginner Essentials and progress to L4 Institutional Tick Backtesting. Every guide includes reading difficulty, estimated reading time, and production-ready code:
Beginner $1,000 Quant Starter Combo Deep-Dive: How Much Can You Earn Monthly Running Polymarket Penny Clipper & LP Bots?
Complete quantitative breakdown for first-time algorithmic traders starting with $1,000 USDC: ranking all 4 Polymarket open-source bot strategies by risk-adjusted edge, modeling 3 realistic monthly profit tiers ($60–$180/mo or 6%–18% monthly ROI) using 5×$200 position splitting, and enforcing the 3 iron survival rules.
Pionex Cloud AI Bots vs. Self-Hosted Polymarket Bots (CloddsBot / Grok Desk): 6 Key Differences & Dual-Engine Allocation Guide
Both are called 'quant trading bots,' yet Pionex's 16 built-in cloud bots and self-hosted open-source Polymarket bots (`CloddsBot`, `polymarket_lp_tool`, `Grok 4-Step Desk`) operate on completely different market mechanics. Pionex harvests crypto volatility and perpetual funding rates with zero code and massive liquidity capacity, while self-hosted Polymarket bots snipe $1.00 deterministic event settlement discounts and Daily LP Rewards with zero correlation to Bitcoin price swings.
Pionex AI Quantitative Trading Complete Guide: 16 Free Built-In Grid Bots, Funding-Rate Arbitrage & Polymarket Delta Hedging
Don't want to maintain a Linux VPS? Master Pionex's 16 free built-in AI trading bots (PionexGPT strategy generator, AI Infinity Grid, Spot-Futures Funding Rate Arbitrage, and 0.05% maker/taker fees) and learn how to pair Pionex BTC/ETH grids with Polymarket event tail-hedges.
CloddsBot & Polymarket LP Bot Complete Guide: Deploy 119-Skill AI Arbitrage, Penny Clipper & Daily Liquidity Rewards Bots
Why pay $5,000+ for black-box bots when the best Polymarket trading engines are MIT open-source on GitHub? Full deployment guide to `alsk1992/CloddsBot` (3.1k⭐, 119+ skills including cross-market arbitrage, Penny Clipper expiry decay, and smart-money copy trading) and `lihanyu81/polymarket_lp_tool` (passive LP market-making for daily USDC rewards).
Grok × Polymarket 4-Step Multi-Agent Trading Desk: SCAN · VERIFY · EXECUTE · EXIT Pipeline That Filters Out 90% of Bad Trades
The best agent on a quantitative trading desk has never placed a trade — its entire job is to say NO. Learn how to replace fragile single-prompt FOMO bots with an institutional 4-Agent Desk (SCAN -> VERIFY -> EXECUTE -> EXIT) for Polymarket CLOB & crypto markets: run free deterministic code filters first, invoke Grok `x_search` only on survivors, size off live cash + pool depth, and enforce 5 pre-written exit rules (`exits.py`) with full `tasks.csv` skip auditing.
Guía Cuant para Polymarket CLOB: Despliega un bot de copia de ballenas y maker con 0% de comisiones usando py-clob-client
Recorrido de ingeniería completo: deriva credenciales L2 de Polygon CLOB, consulta IDs de tokens de condición Gamma, suscríbete a las ejecuciones de ballenas y coloca órdenes límite sin gas con 0% de comisiones EIP-712.
Guía de Seguridad de VPS para Quant, Whitelisting de IP para APIs e Ingeniería de Kill-Switch por Retiro de Capital
Lista de verificación de seguridad en producción para traders cuantitativos: selección de VPS de baja latencia, whitelisting de IP para APIs de exchanges, claves con retiros desactivados y kill-switches automatizados de retiro del 5% diario.
Calibración de Probabilidades con LLMs de IA + Dimensionamiento Half-Kelly: Integración Paso a Paso de las APIs de DeepSeek / OpenAI / Ollama para Órdenes con EV+
Guía completa paso a paso para conectar LLMs de DeepSeek, OpenAI GPT-4o o Ollama locales mediante Python, a fin de analizar noticias de último momento y convertirlas en ratios de verosimilitud bayesiano estructurados y tamaños de posición Half-Kelly.
Tutorial de Freqtrade + FreqAI con Docker: Conecta OKX / Binance, descarga datos históricos y auditá el sesgo de anticipación
Guía paso a paso para desplegar Freqtrade mediante Docker Compose, descargar datos OHLCV de varios años de OKX y Binance, ejecutar pruebas retroactivas (backtests) realistas ajustadas por comisiones y ejecutar `lookahead-analysis`.
Guía de Market Making y Delta-Hedging de Hummingbot: Arbitraje de cuotas de Polymarket frente a Perps de OKX / Binance
Cómo los escritorios institucionales combinan los controladores de market-making de Hummingbot V2 en OKX/Binance con contratos de eventos de Polymarket para construir coberturas de volatilidad macro delta-neutras.
Guía de Backtesting de L2 Orderbook en NautilusTrader: Eliminando ilusiones de slippage y sesgo de posición en cola
Cómo ejecutar backtests de alto nivel de fidelidad del L2 orderbook en NautilusTrader con rellenos realistas de posición en cola, modelado de latencia y validación Walk-Forward.
Poly Day (p.day) — ¿Qué es Polymarket y Cómo Funciona el Mayor Mercado de Predicciones, Apuestas y Cuotas del Mundial?
Guías sobre qué es Polymarket, cómo funciona, cuotas del Mundial, Champions League y depósito USDC sin KYC
Cada vez más traders en España, México, Argentina, Colombia, Perú y Chile buscan «Polymarket qué es», «cómo funciona Polymarket» y cómo participar en el mercado de predicciones descentralizado más líquido del mundo. En Polymarket apuestas sobre eventos reales —desde las elecciones presidenciales y la Reserva Federal hasta la Champions League y la Copa del Mundo (Polymarket World Cup)— comprando acciones «Sí» o «No» entre 0,01 $ y 0,99 $ USDC en la red Polygon.
A través de Poly Day Español (p.day/es/), accedes sin KYC a las cuotas de Polymarket en tiempo real, el rastreador de ballenas (Polymarket Analytics), la guía de la Polymarket App y tutoriales paso a paso para depositar USDC (Polygon) desde Binance P2P, Bitso, Lemon Cash o Belo con comisiones cercanas a cero.