Una API para cuotas en vivo de más de 450 casas de apuestas

¿Qué es Odds-API.io? (resumen de la API de cuotas deportivas)

Odds-API.io es un feed de cuotas para desarrolladores: recoge las cuotas que muestran públicamente más de 450 casas, empareja eventos, equipos y mercados entre ellas y lo sirve todo en un formato JSON vía REST y WebSocket.

• Para casas sin API pública (Bet365, por ejemplo) es una forma fiable de obtener sus líneas de manera programática.
• El mismo partido devuelve el mismo id de evento y los mismos nombres de mercado en todas las casas, así que los precios se comparan directamente.
• Además de las cuotas en bruto, ofrece value bets, arbitraje, cuotas en caída, líneas de cierre y evaluación de apuestas listos para usar.

Como contexto, consulta la introducción oficial a la API de apuestas deportivas y qué es una API de cuotas. Las casas sin API pública, como Bet365, son el caso típico: la integración de la API de cuotas de Bet365 es la forma en que la mayoría de desarrolladores obtiene esas líneas.

Cobertura: Bet365, DraftKings y más de 450 casas, deportes y regiones

34 deportes, más de 12.000 ligas y más de 450 casas, incluidas bolsas y mercados de predicción; la mayoría se cubre prepartido y en vivo.

Principales casas (según la página de cada casa en odds-api.io)

Cifras mostradas en odds-api.io el 2026-11-02; cambian con el tiempo. Según el registro de cambios del 29 oct 2026, están cubiertas las 48 casas italianas con licencia ADM. https://odds-api.io/sportsbooks

34 deportes

Casas por región

Por casa: cuotas y props de DraftKings en Python, precios back, lay y profundidad de Betfair Exchange, API de cuotas de SBOBET. Por deporte: la API de cuotas de fútbol.

API de cuotas en vivo: streaming por WebSocket

WebSocket es la forma recomendada de obtener cuotas: conéctate a wss://api.odds-api.io/v3/ws, suscríbete por mercado y recibe cuotas, marcadores y estado en una sola conexión. Es un complemento de pago (2× el precio del plan en total).

• Obligatorio: markets (p. ej. ML,Spread,Totals); opcional channels=odds,scores,status.
• Filtros: sport (máx. 10), leagues (máx. 20), eventIds (máx. 50), status=live o prematch.
• Reconecta con lastSeq para recuperar mensajes perdidos (retención de 24 horas); replayComplete=true añade un marcador de fin de recuperación.
• Hasta 2 conexiones por clave; el cliente debe soportar permessage-deflate o recibirá HTTP 426.
• Tipos de mensaje: welcome, created, updated, deleted, no_markets, score, status, resync_required. Un mensaje updated sustituye los mercados de esa casa para el evento; no los combines.

// npm i ws   (permessage-deflate is on by default in ws)
import WebSocket from "ws";
let lastSeq;
function connect() {
  const q = new URLSearchParams({ apiKey: process.env.ODDS_API_KEY,
    markets: "ML,Spread,Totals", sport: "football", status: "live" });
  if (lastSeq) q.set("lastSeq", lastSeq);
  const ws = new WebSocket("wss://api.odds-api.io/v3/ws?" + q);
  ws.on("message", (raw) => {
    const msg = JSON.parse(raw);
    if (msg.seq) lastSeq = msg.seq;
    if (msg.type === "updated") {
      // replace this bookmaker's stored markets for the event; do not merge
    }
  });
  ws.on("close", () => setTimeout(connect, 2000));
}
connect();

https://docs.odds-api.io/guides/websockets

API de cuotas en vivo: sondeo vs. WebSocket compara las tres estrategias de actualización. Las apuestas en vivo son las más sensibles a la latencia; el tutorial de stream de cuotas en vivo por WebSocket incluye el código completo.

Ejemplos prácticos: arbitraje, value bets, cuotas de cierre y comparación de cuotas (con código)

Los cuatro ejemplos usan solo endpoints y campos de la documentación oficial. Sustituye YOUR_API_KEY por tu clave y guárdala en una variable de entorno.

import os, requests
r = requests.get("https://api.odds-api.io/v3/arbitrage-bets", params={
    "apiKey": os.environ["ODDS_API_KEY"],
    "bookmakers": "Bet365,SingBet,Unibet",
    "sport": "football", "minProfit": 1, "includeEventDetails": "true"})
r.raise_for_status()
for arb in r.json()[:10]:
    ev = arb.get("event", {})
    print(f'{arb["profitMargin"]:.2f}%  {ev.get("home")} v {ev.get("away")}  {arb["market"]["name"]}')
    for s in arb["optimalStakes"]:      # split of totalStake (1000); scale to your bankroll
        print(f'   {s["bookmaker"]:<10} {s["side"]:<5} stake {s["stake"]:.2f} -> {s["potentialReturn"]:.2f}')

import os, requests
bets = requests.get("https://api.odds-api.io/v3/value-bets", params={
    "apiKey": os.environ["ODDS_API_KEY"], "bookmaker": "Bet365",
    "sport": "football", "includeEventDetails": "true"}).json()
top = sorted((b for b in bets if b["expectedValue"] >= 0.03),
             key=lambda b: b["expectedValue"], reverse=True)[:10]
for b in top:
    side = b["betSide"]
    print(f'EV {b["expectedValue"]*100:.1f}%  {b["event"]["home"]} v {b["event"]["away"]}'
          f'  {b["market"]["name"]} {side} @ {b["bookmakerOdds"][side]}')

import os, requests, statistics
r = requests.get("https://api.odds-api.io/v3/historical/closing-lines", params={
    "apiKey": os.environ["ODDS_API_KEY"], "sport": "football",
    "leagues": "england-premier-league",
    "from": "2026-01-01T00:00:00Z", "to": "2026-05-31T23:59:59Z",
    "markets": "ML", "bookmakers": "Bet365,Unibet", "limit": 100})
margins = {}
for ev in r.json():                      # each item is shaped like /historical/odds
    for book, markets in ev.get("bookmakers", {}).items():
        ml = next((m for m in markets if m["name"] == "ML"), None)
        if not ml: continue
        o = ml["odds"][0]
        overround = sum(1 / float(o[k]) for k in ("home", "draw", "away")) - 1
        margins.setdefault(book, []).append(overround)
for book, xs in margins.items():
    print(f"{book}: {len(xs)} matches, average closing margin {statistics.mean(xs)*100:.2f}%")
# page through with skip=100, 200, ... for more events

curl -s --compressed "https://api.odds-api.io/v3/odds/summary?apiKey=$ODDS_API_KEY&eventId=123456&markets=ML,Totals"
# per line: best / average / median / worst price and a de-vigged "fair" price

Más lecturas: qué son las apuestas de arbitraje, la calculadora de arbitraje, crear un bot de arbitraje en Python, la tutorial de value bets y closing line value y cuotas históricas y de cierre de Bet365.

Precios (verificados el 2026-11-02)

Los cuatro planes solo se diferencian en el número de casas; todos incluyen 5.000 peticiones/hora, todos los deportes y mercados, prepartido y en vivo. El pago anual cuesta 10× el precio mensual.

Enlace de socio — podríamos recibir una comisión. Consulta nuestra divulgación de afiliados.

https://odds-api.io/pricing

Las nuevas claves gratuitas están en pausa; consulta la página oficial de la API de cuotas gratuita y el artículo sobre APIs de cuotas gratuitas en 2026. La página oficial de precios enlazada arriba es la referencia para los planes vigentes.

Glosario

Catorce términos habituales al trabajar con datos de cuotas.

Cuota decimal

Retorno total por cada unidad apostada, incluida la apuesta. odds-api.io devuelve precios decimales como cadenas, p. ej. "2.10".

Probabilidad implícita

1 ÷ cuota decimal. 2,00 equivale al 50 %.

Overround (margen)

Cuánto superan el 100 % las probabilidades implícitas de todos los resultados: el margen de la casa.

Quitar margen / precio justo

Escalar las probabilidades implícitas para que sumen 100 %. El campo fair de /odds/summary usa la mediana de probabilidades sin margen.

Valor esperado (EV)

Definición de la documentación: EV = probabilidad × cuota − 1; un EV positivo indica una value bet.

Arbitraje (surebet)

Cuando los mejores precios entre casas suman menos del 100 %, repartir la apuesta asegura un retorno; impliedProbability < 1 en /arbitrage-bets.

Línea de cierre

El último precio antes del inicio, a menudo considerado el precio de mercado más eficiente.

Closing line value (CLV)

La diferencia entre tu precio y el de cierre; mide si has batido al mercado.

Casa sharp

Casa de límites altos que lidera el descubrimiento de precios; una casa «soft» es lo contrario.

Bolsa de apuestas

Plataforma donde los usuarios apuestan a favor y en contra entre sí (p. ej. Betfair Exchange) y la plataforma cobra comisión.

Cuotas en caída

Una bajada rápida del precio, a menudo por entrada de dinero o información; /dropping-odds mide caídas desde la apertura, 12 h, 24 h y 48 h.

Hándicap asiático

Hándicap sin empate, incluidas líneas de cuarto; en odds-api.io está dentro del mercado Spread.

Props de jugadores

Mercados sobre el rendimiento de un jugador, como tiros, asistencias o puntos.

En vivo

Mercados que se cotizan durante el partido; los precios cambian rápido, por lo que conviene WebSocket.

Más términos y herramientas: probabilidad implícita, value betting, guía de la API de hándicap asiático, la conversor de cuotas y el calculadora de margen de la casa.

Temas populares

Búsquedas frecuentes agrupadas: los dos primeros grupos saltan a la sección correspondiente de esta página; el último lleva a páginas oficiales de odds-api.io.