Genesis Arbitrage

Genesis Arbitrage · · 16 min de lectura

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/arbitrage de 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.

PolymarketKalshi
Grupo de mercadosEvento con uno o más mercadosSerie que contiene eventos
MercadoCondición binaria con resultados Yes y NoMercado binario con un ticker
Resultado en la APIYes y No tienen cada uno su token IDLados YES y NO de un mismo mercado
PrecioDe $0,00 a $1,00Cadena en dólares, p. ej. "0.4200"
Libro de órdenesBids y asks de cada resultadoSolo 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.

APIQué ofrece
Gamma APIEventos y mercados: metadatos, fechas, ID de los resultados
CLOB APIPrecios y libros de órdenes; con claves, órdenes
Data APIPosiciones y actividad de billeteras, historial de precios
WebSocketCanal 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éPolymarketKalshi
Mercados, precios, libros (REST)Sin claveSin clave
Flujo de libros (WebSocket)Canal de mercado, sin claveClave obligatoria, incluso para canales públicos
ÓrdenesFirma de billetera y credenciales CLOBPetició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ónPor qué es difícil
Emparejar eventosLas 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ónLa fuente, la redacción y los casos límite pueden diferir bajo el mismo titular
Fechas de resoluciónLos mercados cierran en días distintos; el dinero queda bloqueado hasta la fecha posterior
ComisionesFórmulas distintas: en Polymarket solo pagan los takers, en Kalshi el tipo de comisión se fija por serie
Profundidad del libroSolo 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.

PataNiveles del libroCoste
YES en Polymarket500 a 0,40 y 500 a 0,41200 + 205 = $405
NO en Kalshi600 a 0,55 y 400 a 0,56330 + 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.

modeQué obtienesPlanes de la API
exactEventos emparejados exactamente en dos plataformas, el modo por defectoStart, Pro, Max
dutchYES en todos los resultados de un evento en una plataformaStart, Pro, Max
llmPares de eventos verificados por IAPro, Max
sportSurebets en 13 plataformas, solo prepartidoPro, 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

EndpointQué devuelvePlanes de la API
/predictions/platformsModo del feed de la plataforma (ws, rest, down), hora de las últimas cotizaciones y del escaneo completo, número de mercadosStart, Pro, Max
/predictions/analyticsOpen interest y volumen, movimientos de precio en 1 h y 24 h, flujos de dineroPro, Max
/predictions/smart-moneyOperaciones grandes y ballenas en 24 h, patrones de insiders, concentración de posicionesPro, Max
/predictions/tradesCinta de operaciones de Polymarket: live desde $1000 y operaciones de billeteras smart desde $100, today y 7d takers desde $5000Pro, Max
/predictions/tradersTop 300 de traders de Polymarket por PnL en 30 días, 7 días o todo el períodoPro, 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.