Skip to Content
Referencia de la APICuotas de cierre por fecha

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/closing

Se 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ámetroTipoObligatorioDescripción
datestringSíFecha en formato YYYY-MM-DD (UTC).
sportstringSíIdentificador del deporte, p. ej. baseball, basketball, football.
leaguestringSíIdentificador de la liga, p. ej. mlb, nba, nfl.
sportsbookstringSí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_idstringNoDevuelve solo este evento de entre los eventos de la fecha. Omítelo para obtener todos los eventos de la fecha.
include_degradedbooleanNoPor 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 -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

CampoTipoDescripción
datestringLa fecha solicitada (YYYY-MM-DD)
sportstringFiltro de deporte aplicado
leaguestringFiltro de liga aplicado
eventsarray | nullEventos 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_eventsintegerNúmero de eventos en la respuesta
total_linesintegerNúmero total de líneas de cierre individuales en todos los eventos y casas de apuestas

Objeto EventEnlace permanente a esta sección

CampoTipoDescripción
event_idstringIdentificador canónico del evento
sportstringDeporte
leaguestringLiga
home_teamstringNombre del equipo local
away_teamstringNombre del equipo visitante
event_start_timestringHora de inicio programada en ISO 8601
captured_atstringMarca temporal ISO 8601 de la primera captura de línea de cierre para este evento
booksobjectMapa de ID de casa de apuestas → payload de cierre por casa (ver abajo)

Payload por casa (books[<sportsbook>])Enlace permanente a esta sección

CampoTipoDescripción
oddsarrayEntradas de líneas de cierre de esta casa (ver abajo)
captured_atstringMomento ISO 8601 en que se capturó la línea de cierre de esta casa
seconds_before_kickoffintegerSegundos 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_triggerstringQué disparó la captura: transition | kickoff | disappearance | evict | backfill (orden de confianza: transition > kickoff > otros)
is_finalbooleanSi 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.

CampoTipoDescripción
sportsbookstringID de la casa de apuestas
market_typestringTipo de mercado: moneyline, point_spread, total_runs, player_earned_runs, etc.
market_idstringIdentificador nativo del mercado en la casa
selectionstringEtiqueta de la selección (nombre del equipo, Over/Under, jugador)
selection_typestringhome, away, over, under, etc.
selection_idstringIdentificador nativo de la selección en la casa
canonical_keystringClave 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.
linenumberValor del spread o total (-3.5, 2.5). Se omite en moneylines y otros mercados sin línea.
odds_americanintegerCuotas americanas al cierre
odds_decimalnumberCuotas decimales al cierre
implied_probabilitynumberProbabilidad implícita bruta (con margen)
no_vig_probabilitynumberProbabilidad 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_decimalnumberPrecio decimal justo (sin margen) al cierre. Presente exactamente cuando lo está no_vig_probability.
closing_probabilitynumberProbabilidad 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_atstringMarca 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_namestringNombre del jugador — solo mercados de props de jugador
stat_categorystringCategoría estadística de la prop de jugador (p. ej. earned_runs, total_bases) — solo mercados de props de jugador
team_sidestringhome | 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_segmentstringTramo del partido que cubre el mercado (1st_half, 1st_5_innings, …). Se omite en mercados de partido completo.
max_betnumberApuesta máxima de la casa en esta selección al cierre — solo en casas que exponen límites (p. ej. Pinnacle)
odds_after_kickoffbooleantrue 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

CampoTipoDescripción
sourcestringAlmacén de respaldo — "clickhouse"
tier_window_daysstringVentana de retroceso — "unlimited" en Enterprise: sin corte móvil, hasta el inicio del archivo el 2026-04-23
filtersobjectEco 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_atstringMarca 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

Last updated on