Caso práctico de Odds-API.io: de la clave de API al análisis con agentes de IA (y qué pasa a la hora de apostar)

Paso 1: ¿Cómo se consigue una clave de API de Odds-API.io?

A 2 de noviembre de 2026, Odds-API.io indica que las nuevas claves gratuitas están en pausa indefinidamente. Las emitidas antes de la pausa siguen funcionando, y si vuelven a emitirse se anunciará en el registro de cambios ^[1]. Hoy el proceso es:

1. Elige un plan en la página de precios de Odds-API.io Enlace de socio. Solo (49 £/mes) es el plan de entrada ^[2].
2. Paga con tarjeta, Apple Pay, Google Pay o PayPal. Los planes mensuales también admiten más de 10 criptomonedas, y los anuales solo tarjeta ^[2].
3. Revisa tu email. La documentación indica que la clave se envía a tu dirección de registro, y la página MCP añade que aparece en el panel en cuanto se confirma el pago ^{[6] [3]}.
4. Elige tus casas en el panel. El plan fija cuántas puedes elegir, y puedes cambiarlas después con la misma clave ^[2].
5. Protege la clave. La documentación advierte que no la subas a un repositorio y la guardes en una variable de entorno como ODDS_API_KEY ^[6].

Antes de pagar puedes probar algunos endpoints. GET https://api.odds-api.io/v3/sports no requiere clave ^[6]:

curl "https://api.odds-api.io/v3/sports"
# → [{"name": "Football", "slug": "football"}, {"name": "Basketball", "slug": "basketball"}, ...]

Descuento por referido: según la página de socios de Odds-API.io, los clientes que llegan mediante un enlace de socio obtienen un 30 % de descuento los 3 primeros meses. Las FAQ de precios añaden que los códigos promocionales y descuentos de afiliado solo se aplican a planes mensuales. Comprueba el precio final en el pago ^{[7] [2]}.

Elige un plan y consigue tu clave → Enlace de socio

Paso 2: ¿Qué diferencia hay entre los planes gratuito y de pago de Odds-API.io?

Los planes de pago solo se diferencian en el número de casas que puedes elegir. Peticiones, deportes y mercados son iguales en todos. El plan gratuito es distinto: tiene muchas menos peticiones, solo admite casas recreativas y ya no acepta nuevos usuarios ^{[2] [1]}.

Elige un plan

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

Precios publicados el 2 nov 2026 ^{[2] [1]}.

• Pago anual: cuesta 10 veces el mensual (dos meses gratis), solo con tarjeta, y no se combina con paquetes de peticiones extra ^[2].
• Streaming por WebSocket: es un complemento que cuesta otra vez el precio del plan (2× en total); por ejemplo, Solo + WebSocket sale a 98 £/mes. Odds-API.io lo recomienda para la menor latencia ^[2].
• Más peticiones: puedes subir a 10.000/hora (+139 £/mes), 20.000/hora (+229 £/mes) o 30.000/hora (+309 £/mes) ^[2].
• Moneda: los precios están en GBP, pero el pago se cobra en moneda local (GBP, USD, EUR, BRL, CNY, JPY o KRW) ^[2].
• Funciones solo de pago: la documentación marca así el mapeo de ids nativos (Polymarket/Kalshi) y las cuotas en caída ^{[8] [9]}.

¿Qué plan necesita este caso? Comparar una casa con Polymarket y Kalshi exige 3 fuentes, es decir, Starter (5). Comparar dos casas con ambos mercados de predicción exige 4, que sigue siendo Starter. Solo sirve para comparar dos fuentes.

Compara los planes de Odds-API.io → Enlace de socio

Paso 3: ¿Cómo dejar que un agente de IA obtenga los datos de Odds-API.io?

Hay dos vías. Puedes darle al agente la documentación para que escriba código REST, o darle herramientas en vivo mediante el servidor MCP oficial. Odds-API.io señala que la mayoría usa ambas ^{[3] [9]}.

Opción A: el servidor MCP oficial (Claude, Codex, Cursor, VS Code)

El servidor es el paquete npm odds-api-mcp-server, de código abierto con licencia MIT. Se ejecuta en tu equipo por stdio y envía la clave solo a api.odds-api.io. Cada llamada a una herramienta es una petición normal y cuenta para tus 5.000/hora ^[3].

# Claude Code
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

# Codex CLI
codex mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

Para Claude Desktop (claude_desktop_config.json) o Cursor (.cursor/mcp.json), añade este bloque ^[9]:

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": { "ODDS_API_KEY": "your-api-key" }
    }
  }
}

VS Code usa .vscode/mcp.json con la clave "servers" en lugar de "mcpServers". También hay una imagen Docker (oddsapi/odds-api-mcp-server) y un archivo .mcpb de instalación en un clic para Claude Desktop ^[3].

Entre las 25 herramientas están get_events, search_events, get_odds, get_multi_odds, get_odds_movements, get_value_bets, get_arbitrage_bets, get_historical_odds y grade_bets. El servidor solo lee datos: no puede iniciar sesión en una casa ni hacer apuestas ^[3].

¿Y ChatGPT?

ChatGPT se conecta a servidores MCP remotos por SSE o HTTP en streaming, así que no puede lanzar directamente un servidor stdio local como odds-api-mcp-server. Para servidores locales o privados, OpenAI ofrece Secure MCP Tunnel ^[10]. En ChatGPT lo más sencillo es la vía de la documentación: Odds-API.io sugiere pedirle que lea https://docs.odds-api.io/llms-full.txt o pegar su bloque de contexto ^[9]. Si quieres herramientas MCP en un producto de OpenAI, el comando de Codex CLI de arriba es la vía admitida.

Opción B: código REST escrito por el agente (Python / TypeScript)

La URL base es https://api.odds-api.io/v3, y la clave va en el parámetro de consulta apiKey ^[9]. Los SDK oficiales son pip install odds-api-io y npm install odds-api-io ^[11].

# Python — official SDK (pip install odds-api-io)
import os
from odds_api import OddsAPIClient

client = OddsAPIClient(api_key=os.environ["ODDS_API_KEY"])
events = client.get_events(sport="football", league="england-premier-league")
odds = client.get_event_odds(event_id=events[0]["id"],
                             bookmakers="Bet365,Polymarket,Kalshi")
for bookie, markets in odds["bookmakers"].items():
    ml = next((m for m in markets if m["name"] == "ML"), None)
    if ml:
        o = ml["odds"][0]
        print(bookie, o["home"], o.get("draw"), o["away"])
print(odds.get("urls", {}))   # direct links to the event at each bookmaker

// TypeScript — official SDK (npm install odds-api-io)
import { OddsAPIClient } from "odds-api-io";

const client = new OddsAPIClient({ apiKey: process.env.ODDS_API_KEY! });
const events = await client.getEvents({ sport: "football", league: "england-premier-league" });
const odds = await client.getEventOdds({ eventId: events[0].id, bookmakers: "Bet365,Polymarket,Kalshi" });
for (const [bookie, markets] of Object.entries(odds.bookmakers)) {
  const ml = markets.find((m) => m.name === "ML");
  if (ml?.odds?.[0]) console.log(bookie, ml.odds[0].home, ml.odds[0].draw, ml.odds[0].away);
}

Pregunta de ejemplo de la página MCP de Odds-API.io: «¿Qué partidos de la Premier League de este fin de semana tienen la mayor diferencia entre Bet365 y Unibet en el resultado final?» El agente la responde con get_events y get_multi_odds ^[3].

Consigue una clave para el servidor MCP → Enlace de socio

Paso 4: El caso práctico: ¿cómo analizar un partido entre casas de apuestas y mercados de predicción?

Datos de ejemplo ilustrativos. Los precios de Polymarket y Kalshi son los valores de muestra de la guía de mercados de predicción de Odds-API.io (Leeds United–Arsenal, mercado 1X2) ^[12]. Las dos filas de casas de apuestas son inventadas para ilustrar. Nada de esto son precios en vivo, resultados, pronósticos ni beneficios.

4.1 La estructura de los datos

GET /v3/odds?eventId=…&bookmakers=Polymarket,Kalshi,Bet365,Unibet devuelve un objeto por evento. Incluye un mapa bookmakers de mercados, urls con enlaces al evento en cada casa y, en mercados de predicción, bookmakerIds más precios back/lay y profundidad en USD ^{[12] [6]}:

"Polymarket": [{ "name": "ML", "odds": [{ "home": "6.67", "draw": "4.35", "away": "1.56",
  "layHome": "1.61", "layAway": "7.14", "layDraw": "4.55",
  "depthHome": "12128", "depthAway": "331", "depthDraw": "26086" }] }]

4.2 Probabilidad implícita y margen (overround)

La probabilidad implícita es 1 ÷ cuota decimal. Los precios en céntimos de los mercados de predicción se convierten igual: 60¢ es un 60 %, es decir, una cuota de 1,67 ^[12]. Sumar los tres resultados muestra el margen de cada fuente:

4.3 Quitar el margen (probabilidades justas)

El método más simple divide cada probabilidad implícita entre el total. El 16,7 / 23,8 / 65,4 de la casa A (suma 105,8) pasa a ser aproximadamente 15,7 % / 22,5 % / 61,8 %, es decir, cuotas justas de aproximadamente 6,35 / 4,45 / 1,62. Este método proporcional es solo uno de varios. El motor de value bets de Odds-API.io calcula las cuotas justas a partir de un panel de casas sharp, porque los márgenes inflados de las casas recreativas sesgan la referencia ^[13].

4.4 Comparar cuotas (line shopping)

El mejor precio por resultado entre las cuatro fuentes es local 6,67 (Polymarket), empate 4,35 y visitante 1,56 (Polymarket y Kalshi). Esos mejores precios suman 102,1 %, por encima del 100 %, así que este partido ilustrativo no tiene arbitraje. La definición de Odds-API.io exige que los mejores precios sumen menos del 100 % ^[14].

4.5 Casa de apuestas frente a mercado de predicción: ¿hay «valor»?

Si usamos como línea justa provisional la media de las probabilidades sin margen de las dos casas ilustrativas (local ≈15,5 %), el 6,67 de Polymarket al local da un EV = 0,155 × 6,67 − 1 ≈ +3 %. Esa es la fórmula de la documentación: EV = probabilidad justa × cuota − 1 ^[13]. En la práctica esa cifra se reduciría o desaparecería porque:

• la referencia son dos precios recreativos inventados, no un consenso sharp ^[13];
• Polymarket y Kalshi cobran comisiones, que el motor de arbitraje de Odds-API.io incorpora con netOdds ^{[14] [15] [16]};
• la profundidad importa: la documentación advierte que un precio con poca liquidez no admite importes relevantes ^[12];
• los precios cambian entre la captura y la orden. La documentación califica las value bets de teóricas y recuerda que no todas ganan ^[13].

# Python: de-vig, line shopping and EV on an /v3/odds response (illustrative)
def implied(o): return 1 / float(o)

def devig(prices):                       # prices = {"home": "6.00", "draw": "4.20", "away": "1.53"}
    p = {k: implied(v) for k, v in prices.items() if k in ("home", "draw", "away")}
    total = sum(p.values())
    return {k: v / total for k, v in p.items()}, total - 1   # fair probs, overround

def best_prices(event):
    best = {}
    for book, markets in event["bookmakers"].items():
        ml = next((m for m in markets if m["name"] == "ML"), None)
        if not ml: continue
        for side in ("home", "draw", "away"):
            price = float(ml["odds"][0][side])
            if side not in best or price > best[side][0]:
                best[side] = (price, book, event.get("urls", {}).get(book))
    return best

def ev(fair_prob, odds): return fair_prob * float(odds) - 1   # docs formula

4.6 Que lo calcule la API: /value-bets y /arbitrage-bets

Odds-API.io también hace estos cálculos por ti. /v3/value-bets?bookmaker=… devuelve expectedValue, betSide y bookmakerOdds.href (enlace a la apuesta), recalculados cada 5 segundos ^[13]. /v3/arbitrage-bets?bookmakers=… devuelve profitMargin, legs[] (con netOdds y maxStake cuando se conocen) y optimalStakes[]. Solo cubre prepartido, y los márgenes son «cálculos a los precios cotizados, no rendimientos garantizados» ^[14].

Nota sobre la documentación: el ejemplo de la guía REST muestra expectedValue como fracción (0,0523 = 5,23 %), mientras que un fragmento del SDK le resta 100 como si fuera un valor en formato porcentual. Comprueba una respuesta real antes de fijar umbrales ^{[13] [11]}.

Haz este análisis con tu propia clave de Odds-API.io → Enlace de socio

Paso 5: Tras el análisis, ¿cómo se apuesta en las distintas plataformas?

Odds-API.io es un servicio de datos: ni la API ni el servidor MCP hacen apuestas ^[3]. Lo que venga después depende de la plataforma y de si es legal para ti.

Casas de apuestas (p. ej. bet365): a mano, mediante el enlace directo

Las respuestas incluyen enlaces al evento en cada casa: urls en /v3/odds, bookmakerOdds.href en value bets y legs[].href en arbitraje, que muestra "N/A" si no se conoce el enlace ^{[6] [13] [14]}. Abre el enlace, entra en una cuenta que tengas legalmente y comprueba que el precio sigue ahí antes de confirmar. No automatices este paso. Los Términos Generales de bet365 (vigentes desde el 28 sep 2026) califican de «Actividades prohibidas» las apuestas de arbitraje (§16.2(e)), usar una VPN para ocultar tu ubicación (§16.2(k)), el scraping (§16.2(w)) y el uso de «inteligencia artificial, jugadores automatizados (bots) y/o software de asistencia al jugador» (§16.2(z)). bet365 también puede anular apuestas que crea colocadas por sistemas automatizados (§14.5(c)) ^[17]. La propia Odds-API.io advierte que las casas pueden limitar las cuentas que encuentran valor de forma constante ^[13].

Polymarket (internacional): SDK oficial, con geobloqueo

Con /v3/mappings?bookmaker=Polymarket conviertes una selección de Odds-API.io en el conditionId y el id de token CLOB de Polymarket (planes de pago) ^[8]. Después usas el SDK oficial de Polymarket (pip install polymarket-client o npm install @polymarket/client) ^[18]:

# Polymarket docs pattern (Python, async)
from polymarket import AsyncSecureClient
client = await AsyncSecureClient.create(private_key=os.environ["POLYMARKET_PRIVATE_KEY"],
                                        wallet=os.environ["POLYMARKET_WALLET_ADDRESS"])
response = await client.place_market_order(asset_id=asset_id, side="BUY", amount="10")  # spend up to 10 pUSD

Polymarket indica que rechaza las órdenes de regiones bloqueadas y pide a los desarrolladores que consulten antes GET https://polymarket.com/api/geoblock. Su lista deja en modo solo cierre a EE. UU., Reino Unido, Francia, Alemania, Italia, Taiwán, Singapur y Australia, entre otros ^{[4] [19]}. Su centro de ayuda indica que usar una VPN para eludirlo incumple sus términos ^[20]. Los usuarios de EE. UU. tienen un mercado aparte regulado por la CFTC, Polymarket US ^[21].

Kalshi: peticiones firmadas, primero en demo

Con /v3/mappings?bookmaker=Kalshi obtienes el ticker del contrato y el lado yes/no ^[8]. Las peticiones a la API de Kalshi llevan las cabeceras KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP y KALSHI-ACCESS-SIGNATURE. La firma cubre timestamp + método + ruta y se genera con tu clave privada ^[22]. Las órdenes son un POST a /portfolio/events/orders. Pruébalo antes en el entorno demo (external-api.demo.kalshi.co) ^{[23] [24]}.

# Kalshi docs pattern (demo): 1 YES contract, limit order
order = {"ticker": market_ticker, "side": "bid", "count": "1", "price": "0.0100",
         "time_in_force": "good_till_canceled", "client_order_id": str(uuid.uuid4())}
r = post(private_key, API_KEY_ID, "/portfolio/events/orders", order)   # signed POST, see Kalshi auth guide

Kalshi exige ser mayor de 18 años y puede pedir documentos de identidad ^[25]. Su aviso del 22 de junio de 2026 prohíbe operar contratos de eventos desde jurisdicciones restringidas como Reino Unido, Canadá, Australia, Francia, Italia, Irlanda, Polonia, Portugal, Suiza, Taiwán, Singapur, Tailandia y la República Popular China ^[5]. En EE. UU., los contratos deportivos de Kalshi están en litigio en tribunales estatales y federales ^[26].

¿Es legal donde estás?

Las normas sobre uso de información privilegiada también se aplican a los contratos de eventos. La CFTC ya ha abierto casos ^{[33] [34]}.

Preguntas frecuentes