API de Polymarket y API de Kalshi: precios, libros de órdenes y arbitraje entre ellas
En resumen
- Polymarket y Kalshi ofrecen mercados, precios y libros de órdenes mediante API REST oficiales sin clave. Para enviar órdenes hace falta una clave y una petición firmada, y en Kalshi también para abrir una conexión WebSocket.
- El precio de un contrato es una fracción de dólar: 0,42 significa 42¢ y, según el mercado, una probabilidad aproximada del 42 %. Solo el libro de órdenes muestra cuánto costará un volumen concreto.
- El arbitraje entre plataformas exige emparejar eventos, comprobar las reglas y las fechas de resolución, recorrer los libros de órdenes y restar las comisiones. El endpoint
/predictions/arbitragede Genesis API devuelve paquetes con todo eso ya calculado; las operaciones las haces tú.
La API de Polymarket y la API de Kalshi son las interfaces de programación oficiales de dos plataformas de mercados de predicción: a través de ellas un programa lee mercados, precios de los contratos YES y NO y libros de órdenes, y con una clave y una petición firmada envía órdenes. Los datos de mercado de ambas plataformas se pueden leer sin clave. Para el arbitraje entre las dos no bastan los precios: hay que emparejar los eventos y calcular el beneficio recorriendo los libros de órdenes con las comisiones. Los paquetes ya preparados los devuelve el endpoint /predictions/arbitrage de Genesis API.
Cómo se estructuran los datos de los mercados de predicción
Un mercado de predicción negocia contratos sobre el resultado de un evento. Cada mercado es una pregunta de sí o no: un contrato YES paga $1 si el evento ocurre, y un contrato NO paga $1 si no ocurre. Cómo resuelven los mercados las plataformas y por qué sus precios se separan se explica en el artículo Mercados de predicción: cómo funcionan Polymarket y Kalshi y en la lección Qué son los mercados de predicción. Aquí se ve cómo aparecen esos mismos objetos en las API.
| Polymarket | Kalshi | |
|---|---|---|
| Grupo de mercados | Evento con uno o más mercados | Serie que contiene eventos |
| Mercado | Condición binaria con resultados Yes y No | Mercado binario con un ticker |
| Resultado en la API | Yes y No tienen cada uno su token ID | Lados YES y NO de un mismo mercado |
| Precio | De $0,00 a $1,00 | Cadena en dólares, p. ej. "0.4200" |
| Libro de órdenes | Bids y asks de cada resultado | Solo bids de YES y de NO |
El precio es una fracción de dólar: 0,42 son 42¢ por un contrato que paga $1 si ocurre su resultado. Por eso el precio se lee como la estimación de probabilidad del mercado, aquí aproximadamente el 42 %. El sitio de Polymarket muestra el punto medio entre el mejor bid y el mejor ask, o el precio de la última operación cuando el spread supera $0,10 (documentación de Polymarket). Para valorar una operación se usa el libro de órdenes.
Libro de órdenes: bids, asks y precios espejo
Un libro de órdenes es la lista de órdenes de compra (bids) y de venta (asks) con sus precios y volúmenes. En Polymarket cada resultado tiene su propio libro, que se pide por token_id. Kalshi devuelve solo bids de ambos lados: un bid de YES al precio X equivale a un ask de NO a $1,00 − X (documentación de Kalshi).
Un ejemplo ilustrativo: el mejor bid de NO en Kalshi es 0,58. Entonces YES se ofrece a 1 − 0,58 = 0,42, es decir, 42¢.
API oficiales de Polymarket y Kalshi
Polymarket
Los datos de Polymarket llegan por tres API REST y flujos WebSocket (resumen de la API). Los datos de mercado, incluidos los precios y libros de órdenes del CLOB, no necesitan clave.
| API | Qué ofrece |
|---|---|
| Gamma API | Eventos y mercados: metadatos, fechas, ID de los resultados |
| CLOB API | Precios y libros de órdenes; con claves, órdenes |
| Data API | Posiciones y actividad de billeteras, historial de precios |
| WebSocket | Canal de mercado para libros y precios; canal de usuario para órdenes y operaciones de la cuenta |
Las órdenes requieren una autenticación CLOB en dos pasos: una firma de la billetera (L1) emite las credenciales CLOB (L2), que firman las peticiones de trading. El ID del resultado para el libro se obtiene de la Gamma API: los mercados v1 lo traen en la cadena JSON clobTokenIds, los v2 en positionIds; el índice 0 es YES y el 1 es NO (campos del mercado). En lugar de peticiones sin procesar se puede usar el SDK oficial de Python, el paquete polymarket-client.
Kalshi
Para los mercados de predicción Kalshi ofrece una API REST (Trade API v2), WebSocket y FIX. El host REST recomendado es external-api.kalshi.com; el antiguo api.elections.kalshi.com sigue funcionando, y hay un entorno demo aparte para pruebas (entornos de la API). Las series, los eventos, los mercados, los libros de órdenes y las operaciones son públicos.
Las peticiones de trading se firman con una clave privada (Ed25519 o RSA): el ID de la clave, la marca de tiempo y la firma van en los encabezados KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP y KALSHI-ACCESS-SIGNATURE (claves API de Kalshi). Las condiciones del mercado, incluidas las reglas de resolución, llegan como texto en rules_primary y rules_secondary; los mejores precios están en yes_bid_dollars, yes_ask_dollars, no_bid_dollars y no_ask_dollars.
Cuándo hace falta una clave
| Qué | Polymarket | Kalshi |
|---|---|---|
| Mercados, precios, libros (REST) | Sin clave | Sin clave |
| Flujo de libros (WebSocket) | Canal de mercado, sin clave | Clave obligatoria, incluso para canales públicos |
| Órdenes | Firma de billetera y credenciales CLOB | Petición firmada con una clave privada |
Leer un libro de órdenes sin clave: curl y Python
# Polymarket: the book of one outcome by token_id
curl "https://clob.polymarket.com/book?token_id=$TOKEN_ID"
# Kalshi: the book of a market by ticker
K=https://external-api.kalshi.com/trade-api/v2
curl "$K/markets/$TICKER/orderbook"
Polymarket devuelve bids y asks, niveles con price y size como cadenas, además de tick_size y min_order_size. Kalshi devuelve un objeto orderbook_fp con los arrays yes_dollars y no_dollars, donde cada nivel es un par de precio en dólares y número de contratos.
Lo que cuesta un volumen concreto solo se ve al recorrer los niveles. Esta función recorre los asks de Polymarket desde el mejor y devuelve el precio mejor, medio y peor:
import requests
CLOB = "https://clob.polymarket.com"
def walk_asks(token_id: str, shares: float):
"""Best, average and worst price to buy `shares` shares.
The platform fee is not included here.
"""
r = requests.get(f"{CLOB}/book", params={"token_id": token_id},
timeout=10)
r.raise_for_status()
left, cost, prices = shares, 0.0, []
for level in reversed(r.json()["asks"]): # the best ask is last
price, size = float(level["price"]), float(level["size"])
take = min(left, size)
cost += take * price
prices.append(price)
left -= take
if left <= 1e-9:
return prices[0], round(cost / shares, 4), prices[-1]
return None # the book is too thin for the full size
print(walk_asks("TOKEN_ID_YES", 1000))
El precio medio es aquí el VWAP de la orden: cuanto más profundo entra una compra en el libro, más se aleja del mejor precio. Esa diferencia es el slippage, y el volumen disponible cerca del mejor precio es la profundidad de mercado.
Por qué es difícil el arbitraje entre Polymarket y Kalshi
El arbitraje de predicción entre plataformas consiste en comprar YES en una y NO en la otra cuando juntos cuestan menos de $1: si ambas resuelven igual, una de las patas paga $1 pase lo que pase. Comparar dos precios mediante las API oficiales es fácil; el par se convierte en una operación solo tras cinco comprobaciones.
| Comprobación | Por qué es difícil |
|---|---|
| Emparejar eventos | Las preguntas se formulan distinto, y los ID y la estructura difieren: un evento con mercados en Polymarket, una serie con eventos en Kalshi |
| Reglas de resolución | La fuente, la redacción y los casos límite pueden diferir bajo el mismo titular |
| Fechas de resolución | Los mercados cierran en días distintos; el dinero queda bloqueado hasta la fecha posterior |
| Comisiones | Fórmulas distintas: en Polymarket solo pagan los takers, en Kalshi el tipo de comisión se fija por serie |
| Profundidad del libro | Solo se vende un número limitado de contratos al mejor precio |
En Polymarket solo paga comisión el taker, y su importe depende del precio de la acción y de la categoría del mercado (comisiones de Polymarket). En Kalshi el tipo de comisión y el multiplicador se definen en la serie, en los campos fee_type y fee_multiplier (series en la API de Kalshi). Hay que tener fondos en ambas plataformas de antemano, y el acceso a cada una depende de tu país y de las reglas de la plataforma.
Ejemplo resuelto: YES en Polymarket, NO en Kalshi
Un ejemplo ilustrativo: el mercado «El evento X ocurre antes del 31 de diciembre» está listado en ambas plataformas con reglas idénticas y se resuelve en 46 días. Quieres 1000 shares de cada lado.
| Pata | Niveles del libro | Coste |
|---|---|---|
| YES en Polymarket | 500 a 0,40 y 500 a 0,41 | 200 + 205 = $405 |
| NO en Kalshi | 600 a 0,55 y 400 a 0,56 | 330 + 224 = $554 |
Los asks de NO en Kalshi salen de los bids de YES: un bid de YES de 0,45 por 600 contratos es un ask de NO a 0,55, y un bid de 0,44 por 400 es un ask a 0,56.
A los mejores precios el par cuesta 0,40 + 0,55 = 0,95: una ventaja de 5¢ por share, es decir, 0,05 / 0,95 = 5,26 % sobre el dinero invertido. Los precios medios de ejecución por los libros son 0,405 y 0,554, juntos 0,959, así que la ventaja se reduce a 4,1¢. Las comisiones del ejemplo son $6 en Polymarket y $17 en Kalshi, $23 en total.
El beneficio es el pago menos el coste de ambas patas y las comisiones, y la tasa anual (APR) se deriva de los días hasta la resolución:
En el ejemplo: 1000 − 959 − 23 = $18 de beneficio, 18 / 982 × 100 = 1,83 % sobre el dinero invertido, y 1,83 × 365 / 46 = 14,5 % anual. Del 5,26 % a los mejores precios sobrevive aproximadamente un tercio tras los libros y las comisiones.
Si ambas plataformas resuelven igual, una pata paga $1000 pase lo que pase: entran $982 y vuelven $18 más. Si las reglas divergen y las dos patas pierden, la pérdida es de $982 completos.
Arbitraje de predicción en Genesis API
El endpoint /predictions/arbitrage devuelve paquetes con ese trabajo ya hecho. Se emparejan los mercados de Polymarket, Kalshi, Limitless, Predict.fun y Opinion, cada pata se recorre por su libro con comisiones y se calculan el beneficio en $ y en %, el APR y los días hasta la resolución. Son los datos de la página Arbitraje de predicciones, en JSON.
mode | Qué obtienes | Planes de la API |
|---|---|---|
exact | Eventos emparejados exactamente en dos plataformas, el modo por defecto | Start, Pro, Max |
dutch | YES en todos los resultados de un evento en una plataforma | Start, Pro, Max |
llm | Pares de eventos verificados por IA | Pro, Max |
sport | Surebets en 13 plataformas, solo prepartido | Pro, Max |
El paquete del ejemplo anterior se vería así en una respuesta, con los campos recortados:
{
"kind": "cross",
"match": "exact",
"title": "Will event X happen by December 31?",
"days_left": 46,
"shares": 1000,
"size_usd": 959,
"fees_usd": 23,
"profit_usd": 18,
"profit_pct": 1.83,
"apr_pct": 14.5,
"risks": [],
"legs": [
{
"platform": "polymarket",
"side": "yes",
"price_best": 0.4,
"price_avg": 0.405,
"price_worst": 0.41,
"cost_usd": 405,
"fee_usd": 6
},
{
"platform": "kalshi",
"side": "no",
"price_best": 0.55,
"price_avg": 0.554,
"price_worst": 0.56,
"cost_usd": 554,
"fee_usd": 17
}
]
}
En una pata, side indica qué comprar: yes, no o bet, una apuesta en una casa de apuestas. price_best, price_avg y price_worst son los precios mejor, medio y peor al recorrer el libro; cost_usd y fee_usd son el coste y la comisión de la pata; url enlaza al mercado. apr_pct es null cuando la resolución queda a menos de un día.
Los códigos de risks señalan lo que las matemáticas no pueden comprobar: rules_differ indica que las reglas de resolución de las plataformas pueden diferir, end_mismatch que sus fechas de resolución difieren. En el modo sport, un paquete con una pata en una casa de apuestas tiene profit_usd = null, porque se desconoce el límite de la apuesta. Las surebets se tratan en el artículo sobre las API de cuotas de casas de apuestas.
Los paquetes se filtran con min_profit_pct, min_profit_usd, min_apr, max_days, platform y category. Todos los filtros y campos están en la guía Mercados de predicción y surebets en Genesis API. Sin código, los mismos paquetes están en la página del servicio; sus columnas y etiquetas se explican en la guía Arbitraje de predicciones.
Estado de las plataformas, analítica y operaciones
| Endpoint | Qué devuelve | Planes de la API |
|---|---|---|
/predictions/platforms | Modo del feed de la plataforma (ws, rest, down), hora de las últimas cotizaciones y del escaneo completo, número de mercados | Start, Pro, Max |
/predictions/analytics | Open interest y volumen, movimientos de precio en 1 h y 24 h, flujos de dinero | Pro, Max |
/predictions/smart-money | Operaciones grandes y ballenas en 24 h, patrones de insiders, concentración de posiciones | Pro, Max |
/predictions/trades | Cinta de operaciones de Polymarket: live desde $1000 y operaciones de billeteras smart desde $100, today y 7d takers desde $5000 | Pro, Max |
/predictions/traders | Top 300 de traders de Polymarket por PnL en 30 días, 7 días o todo el período | Pro, Max |
Pide /predictions/platforms junto con los paquetes: si el feed de una plataforma está en down, sus precios en los paquetes pueden estar desactualizados. Cada operación de la cinta lleva etiquetas de billetera (tags), la marca insider, el rol taker o maker y los valores actuales bid_now y ask_now del resultado. La etiqueta insider describe cómo se comporta una billetera y no prueba nada.
En Trial estos endpoints devuelven 403 plan_restricted. Start cuesta $50 al mes y actualiza los datos cada 30 s, Pro $100 y 10 s, Max $200 y 5 s. Compara los planes en los precios de Genesis API; las mismas pantallas en el sitio son Analítica y Smart Money.
Python: paquetes exact con min_profit_pct y max_days
Cada meta.freshness_sec segundos, el script pide los paquetes exact con al menos un 1 % de beneficio que se resuelven en menos de 60 días. Omite los paquetes con alguna plataforma en down e imprime el resto con sus precios al recorrer el libro. La clave sale de la variable de entorno GENESIS_API_KEY; cómo obtenerla se explica en el inicio rápido.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "exact", "min_profit_pct": 1, "max_days": 60}
def get(path, params=None):
while True:
r = requests.get(f"{API}{path}", headers=HEADERS,
params=params, timeout=10)
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # the period quota is used up
raise SystemExit(f"Wait {wait} s: quota exhausted")
time.sleep(wait)
continue
r.raise_for_status() # 403: endpoint or mode not in your plan
return r.json()
while True:
feeds = get("/predictions/platforms")["data"]["platforms"]
down = {p["platform"] for p in feeds if p["mode"] == "down"}
body = get("/predictions/arbitrage", PARAMS)
for b in body["data"]:
if any(leg["platform"] in down for leg in b["legs"]):
continue # this platform's prices may be stale
print(f"{b['profit_pct']}% · ${b['profit_usd']} · "
f"APR {b['apr_pct']} · {b['days_left']} d · "
f"{b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']} {leg['side']}: "
f"{leg['price_best']} / {leg['price_avg']} / "
f"{leg['price_worst']}, fee ${leg['fee_usd']}")
if b["risks"]:
print(" risks:", ", ".join(b["risks"]))
time.sleep(body["meta"]["freshness_sec"])
Cada ciclo hace dos llamadas. En Start son 2 × 86 400 / 30 = 5760 llamadas al día y 5760 × 30 = 172 800 cada 30 días frente a una cuota de 2 M. Una respuesta filtrada llega sin ETag, así que el ahorro está en el intervalo de polling: consultar más rápido que meta.freshness_sec no aporta datos nuevos. Más en las guías Límites de Genesis API y respuestas y errores.
Preguntas y respuestas
¿Tiene Polymarket una API oficial?
Sí. La Gamma API ofrece eventos y mercados, la CLOB API precios, libros de órdenes y órdenes, la Data API posiciones, actividad e historial de precios, y las actualizaciones de los libros llegan por WebSocket. Los datos de mercado no necesitan clave; las órdenes requieren una firma de billetera y credenciales CLOB. Consulta la documentación de Polymarket.
¿Necesito una clave para leer los mercados de Kalshi?
No para REST: las series, los eventos, los mercados, los libros de órdenes y las operaciones son públicos (inicio rápido de Kalshi). Hace falta una clave para las órdenes y para conectarse al WebSocket, aunque solo quieras canales públicos.
¿Puedo operar a través de Genesis API?
No. Genesis API solo lee datos y no envía órdenes. Abres el paquete tú mismo en las plataformas mediante los enlaces legs[].url. El trading automatizado a través de las API oficiales de Polymarket y Kalshi queda fuera de Genesis API y es bajo tu propio riesgo.
¿Con qué frecuencia se actualizan los datos?
Genesis API sirve una instantánea nueva cada meta.freshness_sec: 30 s en Start, 10 s en Pro y 5 s en Max. La frescura de las cotizaciones propias de las plataformas se ve en quotes_at y full_scan_at de /predictions/platforms.
¿Qué plan de Genesis API necesito para el arbitraje entre Polymarket y Kalshi?
Start: incluye los modos exact y dutch y el estado de las plataformas. Los modos llm y sport, la analítica, el smart money, las operaciones y el ranking de traders están en Pro y Max.