Cuotas de cierre históricas
Obtén las cuotas de cierre capturadas para todos los eventos en una fecha específica — el último precio previo al partido de cada casa de apuestas que indiques (de una a cinco por solicitud) antes de que el evento pasara a directo, con probabilidades sin margen (no-vig) devigadas.
GET /api/v1/historical/odds/closingSe requiere nivel Enterprise. Este endpoint está restringido por la funcionalidad history, disponible únicamente en el nivel Enterprise. Los niveles inferiores reciben un error 403 tier_restricted.
Las líneas de cierre se capturan en tiempo real en las transiciones is_live false→true y se persisten en ClickHouse. No hay límite de ventana móvil: está disponible cada línea de cierre almacenada desde que el archivo comenzó el 23 de abril de 2026 (meta.tier_window_days es "unlimited"). Las fechas anteriores no devuelven eventos, porque antes no se capturó nada.
AutenticaciónEnlace permanente a esta sección
Requiere API key. Se requiere nivel Enterprise (funcionalidad history).
Parámetros de consultaEnlace permanente a esta sección
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
date | string | Sí | Fecha en formato YYYY-MM-DD (UTC). |
sport | string | Sí | Identificador del deporte, p. ej. baseball, basketball, football. |
league | string | Sí | Identificador de la liga, p. ej. mlb, nba, nfl. |
sportsbook | string | Sí | De uno a cinco IDs de casas de apuestas, p. ej. pinnacle o pinnacle,draftkings. Pasa una lista separada por comas, repite el parámetro (sportsbook=pinnacle&sportsbook=draftkings) o ambas cosas. Los duplicados cuentan una vez. Más de cinco casas devuelve 400. |
event_id | string | No | Devuelve solo este evento de entre los eventos de la fecha. Omítelo para obtener todos los eventos de la fecha. |
include_degraded | boolean | No | Por defecto false. Las filas cuyo precio de “cierre” en realidad derivó durante el juego (cotizado mucho después del inicio) se excluyen por defecto. Pasa true para incluirlas — cada una se marca con odds_after_kickoff: true para que puedas excluirla de los cálculos de CLV. |
date, sport, league y sportsbook son obligatorios. La respuesta se filtra a los eventos que coinciden exactamente con el deporte y la liga en esa fecha UTC, y cada evento incluye solo las casas que indicaste. Para más de cinco casas, haz una solicitud por cada grupo de cinco.
Ejemplos de solicitudesEnlace permanente a esta sección
cURL
curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/closing?date=2026-06-30&sport=baseball&league=mlb&sportsbook=pinnacle,draftkings" \
-H "X-API-Key: YOUR_API_KEY"RespuestaEnlace permanente a esta sección
Éxito (200)Enlace permanente a esta sección
Es una respuesta envuelta: { success, data, meta }.
Respuesta real a la solicitud anterior (recortada a un evento, moneyline + una prop de jugador; una respuesta real incluye cada mercado capturado para cada evento de la fecha, por cada casa que indicaste):
{
"success": true,
"data": {
"date": "2026-06-30",
"sport": "baseball",
"league": "mlb",
"events": [
{
"event_id": "mlb_phillies_pirates_2026-06-30_b3",
"sport": "baseball",
"league": "mlb",
"home_team": "Philadelphia Phillies",
"away_team": "Pittsburgh Pirates",
"event_start_time": "2026-06-30T22:40:00Z",
"captured_at": "2026-06-30T22:42:56.227Z",
"books": {
"pinnacle": {
"captured_at": "2026-07-01T02:18:19.094Z",
"seconds_before_kickoff": -13099,
"capture_trigger": "evict",
"is_final": true,
"odds": [
{
"sportsbook": "pinnacle",
"market_type": "moneyline",
"market_id": "1632103992_moneyline_0",
"selection": "Pittsburgh Pirates",
"selection_type": "away",
"selection_id": "away",
"canonical_key": "mlb_phillies_pirates_2026-06-30_b3:moneyline:away",
"odds_american": 182,
"odds_decimal": 2.82,
"implied_probability": 0.35460992907801414,
"no_vig_probability": 0.34684612016316746,
"fair_close_decimal": 2.88312292358804,
"closing_probability": 0.3417584456103625,
"source_updated_at": "2026-06-30T21:22:43.926672195Z",
"max_bet": 15000,
"team_side": "away"
}
]
},
"draftkings": {
"captured_at": "2026-06-30T22:42:58.116Z",
"seconds_before_kickoff": -13099,
"capture_trigger": "backfill",
"is_final": true,
"odds": [
{
"sportsbook": "draftkings",
"market_type": "moneyline",
"market_id": "1_85320694",
"selection": "PIT Pirates",
"selection_type": "away",
"selection_id": "0ML85320694_3",
"canonical_key": "mlb_phillies_pirates_2026-06-30_b3:moneyline:away",
"odds_american": 191,
"odds_decimal": 2.91,
"implied_probability": 0.3436426116838488,
"no_vig_probability": 0.32880208077734696,
"fair_close_decimal": 3.04134328358209,
"closing_probability": 0.3170282527982699,
"source_updated_at": "2026-06-30T20:43:21.398Z",
"team_side": "away"
},
{
"sportsbook": "draftkings",
"market_type": "player_earned_runs",
"market_id": "347277229",
"selection": "Over",
"selection_type": "over",
"selection_id": "0QA347277229#2197684044_13L84240Q1-339433858Q20",
"canonical_key": "mlb_phillies_pirates_2026-06-30_b3:player_earned_runs:chandler_bub:over:2.5",
"line": 2.5,
"odds_american": -136,
"odds_decimal": 1.7352941176470589,
"implied_probability": 0.576271186440678,
"no_vig_probability": 0.5379072681704261,
"fair_close_decimal": 1.8590564938846825,
"closing_probability": 0.5420932938608679,
"source_updated_at": "2026-06-30T22:39:57.090381809Z",
"player_name": "Bubba Chandler",
"stat_category": "earned_runs"
}
]
}
}
}
],
"total_events": 15,
"total_lines": 6096
},
"meta": {
"source": "clickhouse",
"tier_window_days": "unlimited",
"filters": {
"sport": "baseball",
"league": "mlb",
"date": "2026-06-30",
"sportsbook": ["pinnacle", "draftkings"],
"event_id": null
},
"updated_at": "2026-11-07T12:13:58.317932502Z"
}
}data.events es null (no []) cuando ningún evento coincide con los filtros para esa fecha.
Respuestas de errorEnlace permanente a esta sección
400 Error de validación
{
"error": {
"code": "validation_error",
"message": "sportsbook parameter is required"
}
}Otros mensajes 400, todos con el código validation_error: sport parameter is required, league parameter is required, date parameter is required in YYYY-MM-DD format, sportsbook accepts at most 5 books per request, got N, event_id exceeds maximum length e Invalid event_id format.
403 Nivel restringido (nivel incorrecto)
{
"error": {
"code": "tier_restricted",
"message": "This endpoint requires Enterprise tier or higher",
"docs": "https://sharpapi.io/pricing",
"tier": "pro",
"required_tier": "enterprise"
}
}Campos de respuestaEnlace permanente a esta sección
Objeto dataEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
date | string | La fecha solicitada (YYYY-MM-DD) |
sport | string | Filtro de deporte aplicado |
league | string | Filtro de liga aplicado |
events | array | null | Eventos de líneas de cierre que coinciden con la fecha, el deporte y la liga, solo con las casas solicitadas. null cuando no coincide ninguno. |
total_events | integer | Número de eventos en la respuesta |
total_lines | integer | Número total de líneas de cierre individuales en todos los eventos y casas de apuestas |
Objeto EventEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
event_id | string | Identificador canónico del evento |
sport | string | Deporte |
league | string | Liga |
home_team | string | Nombre del equipo local |
away_team | string | Nombre del equipo visitante |
event_start_time | string | Hora de inicio programada en ISO 8601 |
captured_at | string | Marca temporal ISO 8601 de la primera captura de línea de cierre para este evento |
books | object | Mapa de ID de casa de apuestas → payload de cierre por casa (ver abajo) |
Payload por casa (books[<sportsbook>])Enlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
odds | array | Entradas de líneas de cierre de esta casa (ver abajo) |
captured_at | string | Momento ISO 8601 en que se capturó la línea de cierre de esta casa |
seconds_before_kickoff | integer | Segundos antes del inicio en el momento de la captura. Negativo cuando la captura ocurrió después del inicio programado — ligeramente negativo en capturas transition/kickoff, posiblemente horas negativo en capturas evict/backfill (las cuotas siguen siendo los últimos precios previos al partido vistos). |
capture_trigger | string | Qué disparó la captura: transition | kickoff | disappearance | evict | backfill (orden de confianza: transition > kickoff > otros) |
is_final | boolean | Si esta es la captura de cierre final/bloqueada para la casa |
Entrada de línea de cierre (books[<sportsbook>].odds[])Enlace permanente a esta sección
Los campos opcionales se omiten del JSON (no se serializan como null) cuando no aplican — usa comprobaciones de presencia ('line' in entry / .get()) en lugar de comprobaciones de null.
| Campo | Tipo | Descripción |
|---|---|---|
sportsbook | string | ID de la casa de apuestas |
market_type | string | Tipo de mercado: moneyline, point_spread, total_runs, player_earned_runs, etc. |
market_id | string | Identificador nativo del mercado en la casa |
selection | string | Etiqueta de la selección (nombre del equipo, Over/Under, jugador) |
selection_type | string | home, away, over, under, etc. |
selection_id | string | Identificador nativo de la selección en la casa |
canonical_key | string | Clave estable entre casas para unir datos: <event_id>:<market_type>[:<player>]:<selection_type>[:<line>]. Se omite en una pequeña fracción de filas donde no se pudo derivar una clave canónica. |
line | number | Valor del spread o total (-3.5, 2.5). Se omite en moneylines y otros mercados sin línea. |
odds_american | integer | Cuotas americanas al cierre |
odds_decimal | number | Cuotas decimales al cierre |
implied_probability | number | Probabilidad implícita bruta (con margen) |
no_vig_probability | number | Probabilidad justa sin margen, devigada proporcionalmente (0.0–1.0), dentro del par de mercados complementarios de esta casa. Se omite cuando las selecciones capturadas no forman un grupo complementario completo (p. ej. mercados de varias vías, contraparte ausente). |
fair_close_decimal | number | Precio decimal justo (sin margen) al cierre. Presente exactamente cuando lo está no_vig_probability. |
closing_probability | number | Probabilidad justa de cierre devigada con el método Power (el valor usado para CLV). Se omite cuando no había un par complementario disponible. |
source_updated_at | string | Marca temporal ISO 8601 en que el registro de cuotas de origen se confirmó vigente en origen por última vez (última vez visto activo, no último cambio de precio) |
player_name | string | Nombre del jugador — solo mercados de props de jugador |
stat_category | string | Categoría estadística de la prop de jugador (p. ej. earned_runs, total_bases) — solo mercados de props de jugador |
team_side | string | home | away | draw — el eje de equipo para filas ancladas a un equipo (moneylines, totales de equipo). Se omite cuando la fila no está anclada a un equipo. |
market_segment | string | Tramo del partido que cubre el mercado (1st_half, 1st_5_innings, …). Se omite en mercados de partido completo. |
max_bet | number | Apuesta máxima de la casa en esta selección al cierre — solo en casas que exponen límites (p. ej. Pinnacle) |
odds_after_kickoff | boolean | true cuando el precio de la fila se movió por última vez mucho después del inicio (deriva en directo, no un cierre real). Estas filas solo aparecen con include_degraded=true; exclúyelas de los cálculos de CLV. |
Objeto metaEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
source | string | Almacén de respaldo — "clickhouse" |
tier_window_days | string | Ventana de retroceso — "unlimited" en Enterprise: sin corte móvil, hasta el inicio del archivo el 2026-04-23 |
filters | object | Eco de los filtros aplicados: sport, league, date, sportsbook (un array de las casas, en el orden de la solicitud) y event_id (null si no se envió) |
updated_at | string | Marca temporal ISO 8601 de la respuesta |
Casos de usoEnlace permanente a esta sección
Análisis de CLV: Compara no_vig_probability / closing_probability entre casas de apuestas frente a Pinnacle. Una casa blanda con una probabilidad justa más alta en el lado que tomaste cerró más floja — CLV positivo.
Auditoría de line shopping: Obtén las líneas de cierre de varias casas (hasta cinco por solicitud) para entender dónde había valor disponible al cierre (usa canonical_key para alinear la misma selección entre casas).
Calibración de modelos: Usa implied_probability y no_vig_probability como verdad histórica para calibrar tus propios modelos de probabilidad.
Endpoints relacionadosEnlace permanente a esta sección
- Closing Line Value (CLV) — Agregados de CLV% agrupados por casa de apuestas, deporte, liga o día
- Closing Line — Captura de cierre actual o más reciente (Pro+, en tiempo real)
- Snapshot de cuotas — Cuotas actuales en tiempo real
- Oportunidades +EV — Apuestas de valor esperado positivo en tiempo real