Cuotas históricas para backtesting y modelos
Cuotas de cierre de las casas de apuestas que elijas, con el resultado final incluido. Descarga la temporada completa de una liga en unas pocas peticiones, o evento por evento, con la misma API key que usas para las cuotas en vivo.
Última actualización
- Cuotas de cierre desde
- dic 2025
- Por petición masiva
- 366 días
- Casas de apuestas por petición
- 30
- Ligas por petición
- 10
Un mes de cuotas de cierre en una sola petición
/v3/historical/closing-lines devuelve todos los eventos liquidados del periodo con sus cuotas de cierre y el resultado final. Los eventos sin cuotas de tus casas de apuestas también aparecen, con un objeto bookmakers vacío, para que una cuota que falta nunca parezca un partido que falta.
curl "https://api.odds-api.io/v3/historical/closing-lines?apiKey=YOUR_API_KEY\
&sport=football&leagues=england-premier-league,spain-la-liga\
&from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z\
&markets=ML&bookmakers=Bet365,Unibet&limit=100"[
{
"id": 123456,
"home": "Arsenal",
"away": "Chelsea",
"date": "2026-01-14T20:00:00Z",
"status": "settled",
"league": { "name": "England - Premier League", "slug": "england-premier-league" },
"scores": { "home": 2, "away": 1 },
"bookmakers": {
"Bet365": [
{
"name": "ML",
"updatedAt": "2026-01-14T19:58:12Z",
"odds": [{ "home": "2.10", "draw": "3.40", "away": "3.60" }]
}
]
}
}
]Endpoints históricos
Cuatro endpoints históricos y uno para el movimiento de línea. La referencia de la API recoge todos los parámetros.
- GET
/v3/ historical/ closing-lines - Cuotas de cierre de muchos eventos a la vez: hasta 10 ligas, 366 días, 30 casas de apuestas y los mercados que indiques.Planes de pago
- GET
/v3/ historical/ odds - Cuotas de cierre y resultado final de un evento terminado, para hasta 30 casas de apuestas.Todos los planes
- GET
/v3/ historical/ events - Partidos liquidados y resultados finales de una liga en un periodo de hasta 31 días.Todos los planes
- GET
/v3/ historical/ events/ search - Eventos liquidados por nombre de equipo en todas las ligas, del más reciente al más antiguo.Todos los planes
- GET
/v3/ odds/ movements - Movimiento de línea prepartido de un mercado: la cuota de apertura, la última cuota y los cambios entre ambas.Todos los planes
Descarga una temporada en tres pasos
- 1
Elige las ligas y las fechas
Elige un deporte, hasta 10 slugs de liga y un rango de fechas de hasta 366 días, para que una temporada entera quepa en una sola pasada.
- 2
Indica los mercados y las casas de apuestas
markets y bookmakers son obligatorios en el endpoint masivo, con hasta 30 casas de apuestas. Sirve cualquier nombre de /v3/bookmakers, y las cuotas vuelven con ese mismo nombre.
- 3
Recorre la temporada por páginas
Cada respuesta contiene hasta 100 eventos liquidados. Añade skip hasta que una página llegue incompleta. Una temporada de 240 partidos son tres peticiones.
Qué construyen los desarrolladores con ella
Haz backtesting de un modelo de apuestas
Ejecuta un modelo sobre una temporada pasada y compara sus cuotas con el cierre de cada casa de apuestas, con el resultado final en la misma respuesta.
Mide el valor de la línea de cierre
Compara la cuota que tomaste con la de cierre. El historial de movimientos también te da la cuota de apertura, así que ves cuánto se movió la línea.
Crea un dataset de entrenamiento
Obtén las cuotas de cierre de cinco ligas durante una temporada en unas 20 peticiones en lugar de unas 1.900 llamadas, una por partido, en JSON que puedes cargar directamente en un dataframe.
Profundidad de datos y límites
Las listas de eventos y las cuotas de cierre masivas solo devuelven eventos liquidados. Los nombres de mercado coinciden con los que sirve /v3/odds, así que los datos históricos y en vivo se cruzan por las mismas claves.
- Historial de cuotas de cierre
- Desde diciembre de 2025
- Rango de fechas, cuotas de cierre masivas
- 366 días
- Rango de fechas, eventos y búsqueda
- 31 días
- Ligas por petición masiva
- 10
- Casas de apuestas por petición
- 30
- Eventos por respuesta masiva
- 100, paginación con skip
- Formato
- JSON por REST
Preguntas frecuentes sobre la API de cuotas históricas
¿Desde cuándo hay datos de cuotas históricas?
Las cuotas de cierre están disponibles desde diciembre de 2025. Los partidos y resultados finales anteriores siguen disponibles en /v3/historical/events, pero los endpoints de cuotas devuelven esos eventos con un objeto bookmakers vacío.
¿Qué endpoint debo usar para una temporada completa?
/v3/historical/closing-lines. Admite hasta 10 ligas y 366 días por petición y devuelve hasta 100 eventos liquidados por página. Descargar cinco ligas de una temporada evento por evento son unas 1.900 peticiones; el endpoint masivo devuelve los mismos datos en unas 20.
¿Los datos de cuotas históricas están incluidos en mi plan?
/v3/historical/events, /v3/historical/events/search y /v3/historical/odds están disponibles en todos los planes. /v3/historical/closing-lines requiere un plan de pago. La emisión de nuevas claves gratuitas está en pausa, así que Solo, por 49 £/mes, es la forma más económica de empezar.
¿Qué mercados y casas de apuestas están cubiertos?
Guardamos las cuotas de cierre de los eventos liquidados en todas las casas de apuestas y mercados que cubrimos. Los nombres de mercado dependen del deporte: la mayoría usa ML, Totals y Spread, el tenis usa Totals (Games) y Spread (Games), y el béisbol nombra sus cinco primeras entradas de forma completa. Llama a /v3/markets?sport=<sport> para ver los nombres exactos, y a /v3/historical/odds sin filtro de markets para ver todo lo que incluye un evento.
¿Tienen movimientos de línea o solo cuotas de cierre?
/v3/odds/movements devuelve la cuota de apertura, la última cuota y los cambios entre ambas para una línea de mercado. El historial es solo prepartido y se registra para una lista fija de casas de apuestas, que la documentación recoge completa. Está disponible en todos los planes.
¿Se incluyen los partidos sin liquidar o cancelados?
/v3/historical/events, /v3/historical/events/search y /v3/historical/closing-lines solo listan eventos liquidados, así que un partido terminado que aún no se ha liquidado en nuestro sistema no aparece ahí. /v3/historical/odds devuelve el estado del evento, así que compruébalo. Para una respuesta explícita sobre cada evento, incluidos los cancelados, usa la Bet Settlement API.
Empieza tu backtest
Los datos históricos vienen con la misma clave que las cuotas en vivo de 450+ casas de apuestas. Planes desde 49 £/mes.