Las cuotas de las casas ADM italianas, extranjeras y exchanges en una sola API.

GET /api/v1/mock/odds sin clave

Cada endpoint tiene un gemelo bajo /api/v1/mock/ que responde ya, sin registrarte y sin consumir cuota: misma forma de respuesta, mismos parámetros, misma validación estricta que el feed real. Los precios son sintéticos — mock: true, cabecera X-Odss-Mock: 1, ids con prefijo mock_ — sirven para escribir y probar tu código, no para apostar.

curl "https://odss-api.com/api/v1/mock/odds?sport=calcio&limit=3"

Disponibles: /mock/odds · /mock/odds/history · /mock/sports · /mock/bookmakers · /mock/leagues · /mock/status · /mock/stream (SSE) · /mock/ticker (un frame de cuotas 1X2 de ejemplo cada 5 s, sin parámetros). El parámetro seed hace la respuesta reproducible: úsalo en CI en vez de gastar cuota en cada ejecución.

En el feed REAL también son públicos sin clave /api/v1/leagues, /api/v1/coverage, /api/v1/status y /api/v1/pulse.

Primera llamada en 3 pasos

1. Crea la clave Regístrate y genera una clave en el panel. El plan Free es para siempre.
2. Lista los deportes Verifica la clave con una llamada a /sports.
3. Pide las cuotas Llama a /odds con deporte y mercado: recibes las cuotas cross-book.

GET /api/v1/odds ejemplo

curl "https://odss-api.com/api/v1/odds?sport=calcio&league=serie%20a&limit=5" \
  -H "x-api-key: odss_live_..."

const r = await fetch(
  "https://odss-api.com/api/v1/odds?sport=calcio&league=serie%20a&limit=5",
  { headers: { "x-api-key": "odss_live_..." } }
);
const { count, odds } = await r.json();

import requests
r = requests.get(
    "https://odss-api.com/api/v1/odds",
    params={"sport": "calcio", "league": "serie a", "limit": 5},
    headers={"x-api-key": "odss_live_..."},
)
data = r.json()  # { count, offset, returned, state, odds: [...] }

GET /api/v1/odds

Las cuotas cross-book actuales, agrupadas por evento, mercado y línea. Cada registro lista las casas con sus resultados y el timestamp de su última actualización.

Parámetros

Campos de la respuesta

Paginación

Repite la llamada aumentando offset en returned, mientras offset + returned < count. El tablero está vivo: count puede variar ligeramente entre páginas.

GET /api/v1/odds?sport=calcio&limit=1000&offset=0
GET /api/v1/odds?sport=calcio&limit=1000&offset=1000
# … mientras offset + returned < count

GET /api/v1/sports

Los deportes disponibles ahora mismo en el feed (los valores del parámetro sport).

GET /api/v1/bookmakers

Las casas activas en el feed, cada una con estos campos.

GET /api/v1/leagues público, sin clave

El calendario actual agregado: para cada deporte las ligas cotizadas, con número de eventos y de casas. Útil para descubrir valores del filtro league.

GET /api/v1/stream Pro y Enterprise

Server-Sent Events: solo llegan los registros cambiados y los eliminados, sin polling. Con state=live, el live llega normalmente en 10-30 segundos (mediana medida, unos 15 s). Límite de hoy, medido el 8 de octubre de 2026: con state=all una vuelta prematch completa pesa cientos de MB y la conexión se cae antes de recibirla; el stream estuvo sin cambios el 79% del tiempo, con un resync cada 12 minutos aproximadamente. El prematch solo llega con filtros estrechos (deporte, mercado, liga), por oleadas, cuando se renueva el snapshot servido. Estamos reescribiendo la entrega en páginas pequeñas con contrapresión; hasta entonces, para todo el prematch usa el snapshot paginado de /odds.

GET /api/v1/odds/history

Aún no activo. Hoy la captura está apagada: cada llamada responde 200 con count: 0 y history_enabled: false, y cuenta en la cuota. Cuando esté activo: histórico de cambios de cuota de un evento, una fila cada vez que una casa mueve un precio en un grupo. Filtros event_id (obligatorio), book, market, from/to (ISO), limit. Del más reciente: en un evento ya empezado la primera fila es su cierre. Respeta el ámbito de la clave.

curl "https://odss-api.com/api/v1/odds/history?event_id=a3f9c1e07b2d4865&book=snai" \
  -H "x-api-key: odss_live_..."

GET /api/v1/middles

Middles Over/Under calculados del feed actual: OVER en una línea baja en una casa, UNDER en una línea alta en otra. Si el total cae en la ventana ganan ambas apuestas. Campos middle_window, hit_return_pct, miss_return_pct, safe (sin pérdida ni fallando). Filtros: sport, min_return, safe, limit.

Regla de frescura: una cuota parada más de stale_after_seconds (900s por defecto) sigue en las respuestas de /odds con su last_update, pero no se empareja en un middle: una pata vieja probablemente ya no existe en la web de la casa. El umbral aplicado y las patas descartadas están en la respuesta.

Límites de safe, hoy: algunas familias de mercado aún no están separadas por unidad (en tenis y vóley un total de sets puede quedar junto a un total de juegos o de puntos), algunos pseudoeventos «Home - Away» de una plataforma se sirven como partidos, y dos partidos con el mismo nombre pueden compartir un event_id. En esos casos safe: true no es un middle real: antes de actuar comprueba que las dos patas sean el mismo partido, la misma unidad y la misma hora. La respuesta lo recuerda en el campo safe_note.

curl "https://odss-api.com/api/v1/middles?sport=calcio&safe=true" \
  -H "x-api-key: odss_live_..."

GET /api/v1/coverage público, sin clave

Cuántas marcas de casas tienen una cuota válida en el feed de este momento, por región (Italia, USA, UK, mundo). Coincide con las entradas de /api/v1/bookmakers: ambos cuentan un operador una sola vez, con sus líneas de mercado dedicadas (p. ej. <marca>-corners) bajo la marca; en /bookmakers las claves con las que salen sus cuotas están en feed_keys.

GET /api/v1/coverage/matrix público, sin clave

Para cada casa, deporte por deporte: los mercados normalizados que cotiza ahora, con las líneas vistas. Sirve para distinguir tres cosas que una lista plana confunde.

Un mercado no listado bajo una casa attivo es una ausencia estructural: no lo cotiza, y mañana será igual. Las casas en live_only_bookmakers tienen filas pero no en el prepartido, así que sobre sus mercados de prepartido esta respuesta no dice nada; si un carril del feed no respondió, incomplete_lanes lo nombra y la cobertura es parcial, no ausente.

Y un mercado que el motor no sabe mapear con certeza no se adivina: sale como other:<etiqueta> y aquí solo se cuenta (other_markets), porque dos casas lo llaman de formas distintas y comparar esas etiquetas sería un error — las que muchas casas escriben igual están en other_markets_common. Ámbito prematch, recalculada como mucho cada 10 minutos (generated_at).

GET /api/v1/pulse público, sin clave

El latido del feed, solo números agregados (sin precios, sin nombres de casas): es lo que consultan por sí solas las páginas de este sitio. Sin parámetros, Cache-Control: public, max-age=5, límite propio por IP (60 por minuto).

POST /api/mcp MCP

Servidor MCP (JSON-RPC 2.0) para agentes IA y conectores (Claude, ChatGPT…). Autenticación con la misma clave (Authorization: Bearer odss_live_… o x-api-key). Herramientas: get_odds (con state=live), list_sports, list_bookmakers, list_leagues. Solo tools/call consume cuota; el handshake es gratis. Stateless.

curl -X POST https://odss-api.com/api/mcp \
  -H "Authorization: Bearer odss_live_..." -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_odds","arguments":{"sport":"calcio","state":"live","limit":5}}}'

Webhook Enterprise

Registra una URL https y recibe los cambios de cuota por POST, con el mismo payload {changed, removed} que el stream.

Límites, cabeceras y errores

Cada respuesta autenticada incluye X-RateLimit-Limit (cuota mensual del plan), X-RateLimit-Remaining y X-RateLimit-Reset (unix time en segundos en que la ventana se reabre; en el 429 por cuota la misma fecha está en el cuerpo como retry_at). La cuota vale para una ventana de 30 días que empieza con la primera petición del período: al vencer, el contador se pone a cero y vuelve a empezar con la petición siguiente.

curl "https://odss-api.com/api/v1/odds?bookmaker=snai" -H "x-api-key: odss_live_..."

HTTP/1.1 400 Bad Request
{
  "error": "Parametro sconosciuto: \"bookmaker\" (forse intendevi \"bookmakers\"?). Ammessi su questo endpoint: after, bookmakers, changed_since, commence_from, commence_to, content, country, event_id, format, league, limit, market, offset, playable_it, player, sport, state"
}

Recursos para máquinas y agentes

Para generar clientes, SDKs o usar la API desde un agente IA: el contrato OpenAPI 3.1 y una guía breve para LLM son públicos y siempre sincronizados.

Licencia de uso

El uso interno (modelos, bots, análisis, backtests) está incluido en todos los planes. Redistribuir los datos — p. ej. mostrarlos a los usuarios finales de tu producto — requiere la licencia de Redistribución Display (complemento Enterprise, +120 €/mes), que cubre solo la visualización. Crear, alimentar o comercializar servicios de surebet/arbitraje, de value betting o equivalentes exige en cambio la Surebet API, el plan que incluye la licencia para revender las surebets calculadas: 950 €/mes + IVA. Redistribuir la API o los datos brutos queda fuera de todos los planes: para eso, escribe a [email protected].