Genesis Arbitrage

Genesis Arbitrage · · 16 min de lectura

API de apuestas deportivas para arbitraje: eventos, cuotas y surebets por API

En resumen

  • Una API de apuestas deportivas devuelve eventos, mercados y las cuotas de cada casa de apuestas con la hora de la última actualización. La probabilidad implícita de una cuota decimal es 1/k, y el precio de un contrato YES en un mercado de predicción es esa misma probabilidad en dólares.
  • Hay surebet cuando la suma de 1/k de las mejores cuotas de todos los resultados de un mercado es menor que 1, y cada apuesta es proporcional a 1/k. La mayoría de los errores ocurren en la correspondencia: el partido, el mercado, el periodo y la línea deben ser los mismos en todas las plataformas.
  • En mode=sport de los planes Pro y Max, Genesis API devuelve surebets prepartido de 13 plataformas con un stake_unit para cada pata. Su profit_usd es null porque se desconoce el límite de apuesta de la casa de apuestas.

Una API de apuestas deportivas, también llamada API de cuotas, da a un programa acceso a la línea: eventos, mercados y las cuotas de cada casa de apuestas, con la hora en que se actualizó cada precio. Con estos datos el programa compara precios entre plataformas y encuentra surebets: apuestas a todos los resultados de un partido que terminan en beneficio sea cual sea el desenlace, siempre que todas las apuestas se acepten y se liquiden con las mismas reglas. Es el arbitraje de apuestas, y Genesis API sirve surebets ya calculadas de 13 plataformas mediante el endpoint /predictions/arbitrage con mode=sport.

Qué devuelve una API de apuestas deportivas

Cada proveedor nombra los campos a su manera, pero una API de cuotas describe la línea en cinco niveles. Sin el periodo y la línea no se pueden comparar dos cuotas, y sin la hora no se sabe si un precio sigue vigente. La columna derecha es un ejemplo ilustrativo.

NivelQué contieneEjemplo
EventoDeporte, competición, equipos, inicioFútbol, Bundesliga, Bayern — Dortmund
MercadoTipo de apuesta, periodo, líneaTotal 2.5, tiempo reglamentario
ResultadoSobre qué es la apuestaMás de 2.5
PrecioCuotas de cada casa de apuestasFonbet @1.95, Winline @2.02
HoraCuándo se actualizó el preciohace 12 segundos

Las cuotas llegan en formato decimal, fraccionario o americano, y las plataformas de predicción cotizan el precio de un contrato en dólares en lugar de cuotas. Los datos vienen de la API abierta de una plataforma o de un proveedor que reúne las líneas de muchas casas de apuestas en un único formato. Los datos de Polymarket y Kalshi se tratan en el artículo sobre las API de Polymarket y Kalshi.

Cuotas, probabilidad y precios en centavos

Las cuotas decimales muestran cuánto se recupera por cada dólar apostado, incluida la apuesta: 100 $ a @2.25 se convierten en 225 $. Su inversa es la probabilidad implícita: 1 / 2.25 = 0,4444, es decir, 44,44 %. Las cuotas fraccionarias y americanas se convierten a decimales con las fórmulas de Las cuotas de apuestas, explicadas.

PrecioCuota decimalProbabilidad
@2.25 en una casa de apuestas2.2544,44 %
@3.60 en una casa de apuestas3.6027,78 %
YES a 30¢ en Polymarket1 / 0.30 = 3.3330 %

Un contrato YES paga 1 $ si ocurre su resultado, así que su precio en dólares es la estimación de probabilidad del mercado. Un contrato NO sobre «victoria del Bayern» gana si gana el Dortmund o si hay empate, como en la doble oportunidad.

En una sola casa de apuestas las probabilidades de todos los resultados de un mercado suman más de 1, y el exceso es su margen. Ejemplo ilustrativo: la línea de Fonbet en Bayern — Dortmund, 2.15 / 3.45 / 3.40, da 0,46512 + 0,28986 + 0,29412 = 1,04910, un margen del 4,91 %. El cálculo paso a paso está en Cómo calcular el margen de una casa de apuestas.

Cómo encontrar una surebet a partir de las cuotas

Una surebet se encuentra con los mejores precios entre casas de apuestas: para cada resultado del mercado se toma la cuota más alta y se suma 1/k. Ejemplo ilustrativo: el mismo partido, el mercado de resultado final en tiempo reglamentario.

ResultadoMejor cuotaDónde1/k
1, gana el Bayern@2.25Betcity0,44444
X, empate@3.60Marathon0,27778
2, gana el Dortmund@3.80Winline0,26316

L = 0.44444 + 0.27778 + 0.26316 = 0.98538

La suma es menor que 1, así que hay surebet, con un beneficio de 1 / 0.98538 − 1 = 1.48%. Las líneas propias de las cuatro casas de apuestas del código de abajo tienen márgenes del 3,8 % al 5,1 %; la surebet surge de lo distinto que cada una valoró el partido.

La apuesta total se reparte en proporción a 1/k: de 1.000 $, la victoria local recibe 1.000 × 0,44444 / 0,98538 = 451,04 $, y las demás apuestas están en la tabla.

ApuestaImporteSi gana
Betcity · 1 @2.25451,04 $1.014,84 $
Marathon · X @3.60281,90 $1.014,84 $
Winline · 2 @3.80267,06 $1.014,83 $

Cada resultado devuelve unos 1.000 / 0,98538 = 1.014,84 $; el beneficio en el peor caso es de 14,83 $ por el redondeo de las apuestas.

La misma lógica en código, con la línea de un mercado en cuatro casas de apuestas como entrada:

# Illustrative example: one 1X2 market line at four sportsbooks
line = {
    "Fonbet":   {"1": 2.15, "X": 3.45, "2": 3.40},
    "Betcity":  {"1": 2.25, "X": 3.20, "2": 3.40},
    "Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
    "Winline":  {"1": 2.10, "X": 3.35, "2": 3.80},
}


def surebet(line, bank):
    outcomes = next(iter(line.values())).keys()
    # best odds for each outcome and the sportsbook offering them
    best = {o: max((odds[o], bk) for bk, odds in line.items())
            for o in outcomes}
    total = sum(1 / k for k, _ in best.values())
    if total >= 1:
        return None  # no surebet
    for o, (k, bk) in best.items():
        print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
    return round((1 / total - 1) * 100, 2)


print(surebet(line, 1000), "%")  # 1.48 %

Un mercado de dos resultados (hándicap, totales, ambos anotan) tiene dos claves en el diccionario, y la fórmula no cambia. El redondeo de las apuestas y el recálculo cuando se mueven las cuotas se explican en la lección Cómo calcular una surebet.

Correspondencia: un partido, un mercado, un periodo y una línea

La fórmula solo vale si todos los precios pertenecen al mismo mercado del mismo partido. Las casas de apuestas escriben los nombres de los equipos de forma distinta, las horas de inicio difieren en minutos y los mercados tienen nombres propios. Un error de correspondencia produce una surebet falsa: 1/k suma menos de 1, pero en uno de los resultados todas las apuestas pierden.

Qué comprobarDónde fallaCampo en mode=sport
Partido y plantillaBayern frente a Bayern II, un equipo femenino o juvenilteams, flags
InicioUna casa de apuestas tiene el partido reprogramadostarts_at
Tipo de mercadoResultado, hándicap, total, BTTS, resultado exactomarket_type
PeriodoTiempo reglamentario o el partido con prórrogaperiod
LíneaLos hándicaps −1.5 y −1.25 son apuestas distintasline
Resultados de las patasJuntas, las patas deben cubrir todos los resultadoslegs[].covers

El tiempo reglamentario en fútbol son 90 minutos más el tiempo añadido. Las plataformas de apuestas suelen liquidar en él el resultado del partido, los hándicaps y los totales en fútbol y hockey, salvo que el nombre del mercado diga que incluye prórroga y penaltis. Un mercado de ganador en una plataforma de predicción puede incluir la prórroga, y entonces un empate en tiempo reglamentario puede hacer perder todo el par.

Un hándicap forma surebet con el hándicap opuesto del mismo tamaño: local −1.5 y visitante +1.5. En un hándicap asiático de cuarto como −0.75 la apuesta se divide a la mitad entre las dos líneas contiguas, y local −0.75 con visitante +0.75 también cubre cualquier marcador. Los totales se emparejan en una misma línea: más de 2.5 con menos de 2.5.

El par inverso, más de 2.5 y menos de 3.5, es un middle: con tres goles ganan las dos apuestas. En Genesis API line y period se fijan una sola vez para toda la surebet, de modo que las patas con líneas distintas nunca acaban en una misma fila.

Surebets con Genesis API: mode=sport

El endpoint /predictions/arbitrage con mode=sport devuelve surebets en las que este trabajo ya está hecho: los eventos están emparejados entre plataformas, se eligen los mejores precios y las patas de las plataformas de predicción se recorren por el libro de órdenes con comisiones. 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: cuando empieza un partido, su surebet sale de la respuesta.

El modo forma parte de los planes Pro (100 $ al mes, una instantánea nueva cada 10 s) y Max (200 $, cada 5 s); en Trial y Start la petición devuelve 403 plan_restricted. La API no devuelve la línea completa de cada casa de apuestas: la respuesta contiene solo las surebets encontradas, con la plataforma, el resultado y el precio de cada pata.

curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
  -d mode=sport -d sport=soccer -d min_profit_pct=1.5

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

{
  "id": "s:8812:RT:TOT:2.5:",
  "kind": "sport",
  "match": "sport",
  "title": "Arsenal — Chelsea",
  "category": "sports",
  "sport": "soccer",
  "league": "Premier League",
  "teams": ["Arsenal", "Chelsea"],
  "market_type": "TOT",
  "period": "RT",
  "line": 2.5,
  "score": null,
  "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"
    }
  ]
}

Los cinco niveles de la línea se corresponden con los campos de la fila:

NivelCamposEn el ejemplo
Eventotitle, sport, league, teams, starts_atArsenal — Chelsea, soccer, Premier League
Mercadomarket_type, period, line, scoreTOT, FT, 2.5
Pataplatform, side, outcome, coversfonbet, bet, Under 2.5, U
Precioodds, price_avg, stake_unit, currency2.12, 0.471698, RUB
Resultadosize_usd, profit_pct, profit_usd1000, 2.39, null

market_type es el mercado: WIN, resultado del partido; HCP, hándicap; TOT, total; BTTS, ambos equipos anotan; CS, resultado exacto, con el marcador en score. side es yes o no para la compra de un contrato y bet para una apuesta a cuota. covers enumera los resultados que cubre una pata: aquí O es más y U es menos.

Cómo repartir la apuesta con stake_unit

stake_unit es lo que hay que poner en una pata para que devuelva 1 $ si gana. En una apuesta a cuota es 1 / odds: 1 / 2.12 = 0,471698. En la compra de YES o NO es el precio medio del libro de órdenes incluida la comisión; el ejemplo ilustrativo no tiene comisión, así que stake_unit es igual a price_avg.

Las unidades suman 0,505 + 0,471698 = 0,976698, así que el beneficio es 1 / 0.976698 − 1 = 2.39%. Reparte tu propio importe S con la fórmula de la surebet: apuesta de la pata = S × stake_unit / Σ stake_unit. Para 500 $:

PataImporteSi gana
Polymarket · YES «Over 2.5» a 50,5¢258,52 $511,92 acciones — 511,92 $
Fonbet · Under 2.5 @2.12241,48 $511,94 $

Cualquiera de los dos resultados devuelve unos 511,93 $, un beneficio en el peor caso de 11,92 $. size_usd es lo que absorben los libros de órdenes de las plataformas de predicción a estos precios. Aquí son 1.000 $: 1.000 / 0,505 ≈ 1.980,2 acciones, así que la apuesta en Fonbet podría llegar a 1.980,2 × 0,471698 ≈ 934,06 $ si la casa de apuestas la acepta.

profit_usd es null porque el beneficio en dólares depende de cuánto acepte Fonbet, y la casa de apuestas no publica su límite de apuesta. Por eso el filtro min_profit_usd descarta toda surebet con una pata en una casa de apuestas: fíltralas por min_profit_pct.

La apuesta en Fonbet está en rublos (currency = RUB). A un tipo de cambio ilustrativo de 80 ₽ por 1 $, son 241,48 × 80 = 19.318,40 ₽, y menos de 2.5 devuelve 19.318,40 × 2.12 = 40.955,01 ₽. El diferencial del tipo de cambio en la conversión no está incluido en profit_pct.

Python: surebets de fútbol con min_profit_pct

El script pide surebets de fútbol con un beneficio del 1,5 % o más, imprime cada una con el tiempo que falta para el inicio y reparte el importe BANK entre las patas según stake_unit. La clave sale de la variable de entorno GENESIS_API_KEY; cómo obtenerla está 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": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500  # total stake for the whole surebet, $


def fetch():
    while True:
        r = requests.get(f"{API}/predictions/arbitrage",
                         headers=HEADERS, params=PARAMS, timeout=10)
        if r.status_code in (429, 503):
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        if r.status_code == 403:
            raise SystemExit("mode=sport needs the Pro or Max plan")
        r.raise_for_status()
        return r.json()["data"]


def unit(leg):  # $1 of winnings: stake_unit, else 1/odds or price
    if leg.get("stake_unit"):
        return leg["stake_unit"]
    return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]


for row in fetch():
    mkt = [row["market_type"], row["line"], row["period"]]
    mkt = " ".join(str(v) for v in mkt if v is not None)
    hours = (row["starts_at"] - time.time()) / 3600
    print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
          f"starts in {hours:.1f} h")
    total = sum(unit(leg) for leg in row["legs"])
    for leg in row["legs"]:
        price = leg.get("odds") or leg.get("price_avg")
        print(f"   {leg['platform']}: {leg['outcome']} at {price} — "
              f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")

El importe de cada pata se imprime en dólares junto a la moneda de la plataforma: convierte una apuesta en rublos a tu propio tipo de cambio. Si una pata no tiene stake_unit, unit recurre a 1 / odds o price_avg sin la comisión, de modo que el beneficio sale algo más alto de lo que es en realidad.

Para seguir las surebets nuevas, repite la petición cada meta.freshness_sec y compara los valores de id: cada surebet conserva su id. Una respuesta filtrada llega sin ETag, así que ahorras cuota con el intervalo: una petición cada 10 s en Pro son 86.400 / 10 = 8.640 llamadas al día y 8.640 × 30 = 259.200 en 30 días frente a una cuota de 5M, véanse los límites de Genesis API. Los filtros league, platform (por ejemplo fonbet) y max_days se describen en la guía de endpoints de mercados de predicción.

Riesgos que la API no puede comprobar

La API valora una surebet a partir de una instantánea, mientras que las apuestas las haces tú en dos o tres plataformas, y cada una de ellas puede romper el cálculo.

Las apuestas se regulan de forma distinta en cada país: consulta las leyes locales y las reglas de cada plataforma. El orden de trabajo y todos los riesgos están reunidos en la lección Riesgos de las surebets y reglas de trabajo, y cómo funciona la búsqueda se explica en Escáner de surebets.

Las columnas, los filtros y las etiquetas se describen en la guía del modo Sport.

Preguntas y respuestas

¿Existe una API de apuestas deportivas gratuita?

Depende del proveedor: las cuotas de peticiones y la lista de casas de apuestas y mercados varían, y el acceso gratuito, donde existe, tiene un volumen limitado. Polymarket y Kalshi sirven datos de mercado con sus API oficiales sin clave (Polymarket, Kalshi), pero son precios de contratos YES y NO, sin cuotas de casas de apuestas. Genesis API no tiene plan gratuito: mode=sport está en Pro (100 $ al mes) y Max (200 $); compara los planes en los precios de Genesis API.

¿La API tiene cuotas en vivo?

No en Genesis API: el modo sport busca solo surebets prepartido, y una surebet sale de la respuesta en cuanto empieza el partido. Por qué los arbitrajes en vivo fallan más a menudo se explica en Arbitraje prepartido frente a en vivo.

¿Por qué profit_usd es null en una surebet?

Al menos una pata es una apuesta en una casa de apuestas, y la casa de apuestas no publica el límite de apuesta de tu cuenta. El porcentaje profit_pct se conoce; calcula el importe de cada pata a partir de stake_unit.

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

No. Genesis API solo lee datos: las apuestas y compras las haces tú en las plataformas, con los enlaces de legs[].url.