Genesis Arbitrage

Genesis Arbitrage · · 13 min de lectura

Mercados de predicción y surebets en Genesis API: endpoints, filtros y campos

En resumen

  • Seis endpoints: arbitraje de predicción y estado de las plataformas desde el plan Start; analítica, smart money, grandes operaciones y ranking de traders en Pro y Max.
  • Los paquetes de arbitraje llegan calculados con los libros de órdenes y las comisiones: tamaño de la operación, beneficio en $ y %, APR, días hasta la liquidación y códigos de riesgo.
  • El modo sport devuelve surebets en 13 plataformas, solo prepartido. Cuando una pata es una apuesta a cuota, profit_usd es null porque se desconoce el límite de apuesta.

Genesis API ofrece datos de mercados de predicción mediante seis endpoints GET: paquetes de arbitraje entre Polymarket, Kalshi, Limitless, Predict.fun y Opinion, surebets en 13 plataformas, estado de las plataformas, analítica, smart money, grandes operaciones y el ranking de traders. Son los datos de las páginas Arbitraje de predicción, Analítica y Smart Money, en formato JSON. Con ellos puedes montar un bot, un panel o alertas; las operaciones y apuestas las haces tú en las plataformas.

Endpoints y planes

EndpointQué devuelvePlanes de API
/predictions/arbitragePaquetes de arbitraje y surebetsStart, Pro, Max; modos llm y sport — Pro, Max
/predictions/platformsEstado de las plataformasStart, Pro, Max
/predictions/analyticsKPI, movimientos de precio, flujos de dineroPro, Max
/predictions/smart-moneyGrandes operaciones, ballenas, patrones de insidersPro, Max
/predictions/tradesCinta de operaciones de PolymarketPro, Max
/predictions/tradersTop 300 de traders de Polymarket por PnLPro, Max

En Trial los seis devuelven 403 plan_restricted; en Start también lo hacen las peticiones con mode=llm y mode=sport. El formato de las respuestas se explica en la guía de respuestas y errores, la cuota en la guía de límites.

Arbitraje de predicción: modos

El parámetro mode elige qué paquetes devuelve /predictions/arbitrage.

modeQué obtieneskindPlanes
exactEl mismo evento en dos plataformas, el valor por defectocrossStart, Pro, Max
dutchUn conjunto de resultados de un evento en una plataformadutchStart, Pro, Max
llmPares de eventos verificados por IAcrossPro, Max
sportSurebets en partidossportPro, Max

El beneficio ya está calculado con los libros de órdenes de las plataformas y las comisiones. Petición de paquetes exact con al menos un 1 % de beneficio que se liquiden en 30 días:

curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d mode=exact -d min_profit_pct=1 -d max_days=30

Filtros

ParámetroTipoQué hace
modestringexact (por defecto), dutch, llm o sport
categorystringCategoría, como en el campo category
platformstringAl menos una pata en esta plataforma; varias, separadas por comas
min_profit_pctnumberBeneficio mínimo, %
min_profit_usdnumberBeneficio mínimo, $; se omiten las filas con profit_usd = null
min_aprnumberAPR mínimo, %
max_daysnumberComo máximo estos días hasta la liquidación
sport, leaguestringDeporte y liga, para mode=sport

Los filtros son opcionales y se combinan. Escribe la plataforma como en legs[].platform: polymarket, kalshi, fonbet. Un mode desconocido devuelve 400 bad_request.

Un paquete y sus patas

Ejemplo ilustrativo: una fila mode=exact de la documentación, abreviada.

{
  "id": "x:exact:kalshi:KXFRENCHPRES-27-JCAS~polymarket:0x8c1f…",
  "kind": "cross",
  "match": "exact",
  "title": "Will Jean Castex win the 2027 French presidential…",
  "category": "Elections",
  "ends_at": 1843308000,
  "days_left": 562.87,
  "size_usd": 107175.08,
  "fees_usd": 28.08,
  "profit_usd": 153.69,
  "profit_pct": 0.14,
  "apr_pct": 0.1,
  "shares": 107356.85,
  "risks": ["rules_differ", "end_mismatch"],
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "outcome": "Jean Castex",
      "price_avg": 0.0013,
      "cost_usd": 140.3,
      "fee_usd": 5.6,
      "url": "https://polymarket.com/event/next-french-presidential-…"
    },
    {
      "platform": "kalshi",
      "side": "no",
      "outcome": "No",
      "price_avg": 0.997,
      "cost_usd": 107034.78,
      "fee_usd": 22.48,
      "url": "https://kalshi.com/events/KXFRENCHPRES-27"
    }
  ]
}
CampoSignificado
id, first_seen, updated_atId estable, cuándo apareció el paquete y cuándo se actualizó
kind, matchcross, dutch o sport; match es exact, llm o sport
title, categoryEvento o mercado y su categoría
ends_at, days_left, starts_atMomento de liquidación, días hasta la liquidación, inicio del partido
size_usd, fees_usd, sharesTamaño de la operación y comisiones en $, número de shares
profit_usd, profit_pct, apr_pctBeneficio en $ y %, APR; apr_pct es null con menos de un día
edge_cents, risksVentaja de precio en centavos por share, códigos de riesgo
legs[].platform, market, outcomePlataforma, mercado y resultado de la pata
legs[].sideyes o no — qué comprar; bet — una apuesta a cuota
legs[].price_best, price_avg, price_worstMejor precio, precio medio y peor precio al recorrer el libro
legs[].shares, cost_usd, fee_usd, urlShares, coste, comisión y enlace al mercado de la pata

El precio de una pata es una fracción de dólar: una share devuelve 1 $ si su resultado gana, así que 0.997 son 99,7 ¢. Si ambas plataformas liquidan igual, una pata gana pase lo que pase, y shares es la cantidad que recibes. rules_differ indica que las reglas de liquidación de las plataformas pueden diferir; end_mismatch, que sus fechas de liquidación no coinciden.

En el ejemplo, 107.356,85 − 107.175,08 − 28,08 = 153,69 $ de beneficio, es decir, 153,69 / 107.203,16 = 0,14 %. El dinero queda bloqueado 562,87 días hasta la liquidación, así que la tasa anual resulta 0,14 × 365 / 562,87 ≈ 0,1 %. El filtro max_days descarta esos paquetes.

Modo sport: surebets

Una fila sport es un mercado de un partido: 2 o 3 patas en plataformas distintas que juntas cubren todos sus resultados. Son 13 plataformas: Polymarket, Kalshi, Predict.fun y 10 plataformas de apuestas — Fonbet, Betcity, Olimpbet, Marathon, 5051X, Melbet, Winline, BC.Game, EGB y Dafa Sports. Solo prepartido: en cuanto empieza el partido, la surebet sale de la lista.

Ejemplo ilustrativo: una fila mode=sport de la documentación con precios recalculados.

{
  "id": "s:8812:RT:TOT:2.5:",
  "kind": "sport",
  "title": "Arsenal — Chelsea",
  "sport": "soccer",
  "league": "Premier League",
  "teams": ["Arsenal", "Chelsea"],
  "market_type": "TOT",
  "period": "RT",
  "line": 2.5,
  "starts_at": 1794700800,
  "size_usd": 1000,
  "profit_usd": null,
  "profit_pct": 2.39,
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "outcome": "Over 2.5",
      "covers": ["O"],
      "price_avg": 0.505,
      "odds": null,
      "stake_unit": 0.505,
      "currency": "USD"
    },
    {
      "platform": "fonbet",
      "side": "bet",
      "outcome": "Under 2.5",
      "covers": ["U"],
      "odds": 2.12,
      "stake_unit": 0.471698,
      "currency": "RUB"
    }
  ]
}
CampoSignificado
sport, league, teams, flagsDeporte, liga, equipos, etiquetas del partido
market_typeWIN — resultado, HCP — hándicap, TOT — total, BTTS — ambos equipos marcan, CS — resultado exacto
period, line, scorePeriodo de liquidación, línea de hándicap o total, marcador para CS
legs[].coversResultados que cubre la pata: O — más de, U — menos de
legs[].oddsCuota decimal; null para una compra de YES o NO
legs[].stake_unitParte de la apuesta: cuánto poner en la pata para obtener 1 $ si gana, comisiones incluidas
legs[].currencyLa moneda de la plataforma

Para una apuesta a cuota, stake_unit = 1 / odds: 1 / 2,12 = 0,471698. Las unidades de apuesta de todas las patas suman 0,505 + 0,471698 = 0,976698, por debajo de 1, de ahí un beneficio de 1 / 0,976698 − 1 = 2,39 %. Para repartir tu propio importe, usa apuesta de la pata = importe × stake_unit / Σ stake_unit.

size_usd es el importe de compras en plataformas de predicción que sus libros de órdenes pueden absorber. Con 1.000 $ a 0,505 se compran 1.000 / 0,505 ≈ 1.980,2 shares YES de «Over 2.5». Para que «Under 2.5» devuelva lo mismo, la apuesta en Fonbet es 1.980,2 × 0,471698 ≈ 934,06 $.

Fonbet acepta apuestas en rublos (currency = RUB): convierte el importe a tu propio tipo de cambio, porque el cambio no forma parte de profit_pct. Aquí profit_usd es null porque la plataforma de apuestas no publica su límite de apuesta.

Estado de las plataformas

/predictions/platforms muestra cuán frescos son los datos de arbitraje. No tiene parámetros; data contiene dos listas:

{
  "platforms": [
    {
      "platform": "kalshi",
      "mode": "rest",
      "quotes_at": 1794675858,
      "full_scan_at": 1794675012,
      "markets": 26187,
      "hot_markets": 188
    }
  ],
  "bookmakers": [
    {
      "bookmaker": "fonbet",
      "title": "Fonbet",
      "ok": true,
      "events": 1840,
      "matched_events": 212,
      "updated_at": 1794675855,
      "currency": "RUB"
    }
  ]
}

Conviene omitir los paquetes con una plataforma en down o con ok = false: sus precios pueden haberse movido.

Analítica, smart money, operaciones y traders

Cuatro endpoints de Pro y Max replican las pantallas de las guías de Analítica y Smart Money.

EndpointParámetrosQué contiene
/predictions/analyticsningunoKPI, movimientos de precio en 1 h y 24 h, flujos de dinero, mercados que se liquidan pronto, mercados nuevos
/predictions/smart-moneyningunoKPI, flujos de dinero, insiders, concentration, smart_vs_price
/predictions/tradesperiod, wallet, category, side, min_usd, insiderOperaciones de Polymarket, las más recientes primero
/predictions/tradersperiod: 30d (por defecto), 7d, allTop 300 de traders de Polymarket por PnL

La etiqueta insider describe el patrón de comportamiento de una wallet y no prueba nada: una dirección nueva de un trader con experiencia puede operar igual.

Parámetros de la cinta de operaciones; period fija el umbral:

ParámetroTipoQué hace
periodstringlive (por defecto) — operaciones desde 1.000 $, desde 100 $ para una wallet smart; today y 7d — takers desde 5.000 $
walletstringOperaciones de una wallet
categorystringCategoría del mercado
sidestringbuy o sell
min_usdnumberImporte mínimo de la operación, $
insiderbooleantrue — solo operaciones con etiqueta insider
curl -G "https://api.genesisarbitrage.com/v1/predictions/trades" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d period=today -d side=buy -d min_usd=10000
{
  "ts": 1794675812,
  "wallet": "0x3a1c…f09e",
  "tags": ["whale", "smart"],
  "title": "Will Bitcoin reach $150k in 2026?",
  "outcome": "No",
  "side": "buy",
  "price": 0.82,
  "shares": 30487.8,
  "usd": 25000,
  "role": "taker",
  "insider": false,
  "bid_now": 0.81,
  "ask_now": 0.83
}

usd = price × shares: 0,82 × 30.487,8 ≈ 25.000. bid_now y ask_now son los precios actuales del resultado: seguir esta operación ahora cuesta 0,83, 1 ¢ más de lo que pagó el trader.

/predictions/traders da el PnL de todo el tiempo, de 30 y de 7 días (pnl_usd), roi_pct, won de resolved y el minigráfico pnl_series. Pon una dirección del ranking en el wallet de la cinta de operaciones.

Cómo usarlo

  1. Comprueba tu plan y las plataformas

    /account/usage muestra tu plan, /predictions/platforms — cuán frescas son las cotizaciones.

  2. Pide paquetes con filtros

    min_profit_pct y max_days recortan el ruido y los paquetes a largo plazo.

  3. Revisa los riesgos y las reglas

    Con rules_differ, lee las reglas de liquidación de ambas plataformas.

  4. Consulta sin superar la frescura de tu plan

    Usa un intervalo de al menos meta.freshness_sec y devuelve el ETag en If-None-Match: una respuesta 304 no consume cuota.

  5. Opera tú mismo

    Abre el mercado desde legs[].url y comprueba el precio en su libro de órdenes.

La misma petición exact en Python:

import os
from datetime import datetime, timezone

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": 30}

r = requests.get(f"{API}/predictions/arbitrage", headers=HEADERS,
                 params=params, timeout=10)
if r.status_code == 403:
    raise SystemExit("Endpoint or mode is not part of your API plan")
r.raise_for_status()
body = r.json()
ts = datetime.fromtimestamp(body["meta"]["updated_at"], timezone.utc)
print(f"Bundles: {body['meta']['count']}, data as of {ts:%H:%M:%S} UTC")

for b in body["data"]:
    print(f"{b['profit_pct']:.2f}% · ${b['profit_usd']:.2f} · "
          f"{b['days_left']:.0f} d · {b['title'][:40]}")
    for leg in b["legs"]:
        print(f"   {leg['platform']}: {leg['side']} "
              f"{leg['outcome']} at {leg['price_avg']}")
    if b["risks"]:
        print("   risks:", ", ".join(b["risks"]))

En el sitio, estos mismos paquetes se explican en las guías Arbitraje de predicción y Modo Sport; las API oficiales de las plataformas, en los artículos sobre las API de Polymarket y Kalshi y sobre las cuotas de apuestas por API.

Preguntas y respuestas

¿Puedo comprar contratos o hacer apuestas a través de Genesis API?

No. Genesis API solo lee datos y no envía órdenes: operas y apuestas tú mismo en las plataformas.

¿Por qué profit_usd es null en una surebet?

Al menos una pata es una apuesta a cuota y la plataforma no publica su límite de apuesta. El porcentaje de beneficio se conoce; calcula el importe de cada pata a partir de stake_unit.

¿La API incluye surebets en vivo?

No, solo prepartido. Por qué el directo es más arriesgado se explica en el artículo sobre prepartido frente a en vivo.

¿Qué plan necesito para las surebets?

Pro o Max: en Start, mode=sport devuelve 403 plan_restricted. Los precios están en la página Precios de Genesis API.