Skip to Content
Referencia de la APIDetalles del evento

Detalles del evento

Obtén información detallada de un único evento, incluidos los mercados disponibles y los metadatos.

GET /api/v1/events/{eventId}

AutenticaciónEnlace permanente a esta sección

Requiere una API key mediante la cabecera X-API-Key, la cabecera Authorization: Bearer o el parámetro de consulta api_key. Disponible en todos los planes.

Parámetros de rutaEnlace permanente a esta sección

ParámetroTipoObligatorioDescripción
eventIdstringSíIdentificador único del evento (p. ej., evt_nba_bos_lal_20260208)

Cabeceras de respuestaEnlace permanente a esta sección

Todas las respuestas incluyen cabeceras estándar de límite de tasa (rate limit) y de metadatos:

CabeceraDescripción
X-RateLimit-LimitNúmero máximo de solicitudes por minuto para tu plan
X-RateLimit-RemainingSolicitudes restantes en la ventana actual
X-RateLimit-ResetMarca de tiempo Unix en la que se restablece la ventana de rate limit
X-Data-DelayRetardo de los datos para tu plan (p. ej., 0s, 60s)
X-Request-IdIdentificador único de la solicitud, útil para depuración

Objeto de detalle del eventoEnlace permanente a esta sección

CampoTipoDescripción
idstringIdentificador canónico del evento — el mismo para cada sportsbook que cubra este evento. Úsalo como clave principal para emparejar entre books. Consulta Emparejamiento de eventos.
external_idsobjectMapa del ID del sportsbook al ID nativo del evento en ese book (p. ej., { "draftkings": "12345", "fanduel": "67890" }). Úsalos para enlaces directos (deep linking) a las páginas del sportsbook.
sportstringIdentificador del deporte (p. ej., basketball, football)
leaguestringNombre de la liga (p. ej., NBA, NFL)
home_teamstringNombre del equipo local
away_teamstringNombre del equipo visitante
start_timestringHora de inicio del evento en formato ISO 8601. Ausente en un evento finalizado servido desde el almacén de retención — comprueba la presencia de la clave, no el status.
completed_atstringHora de finalización en ISO 8601. Presente solo en filas con status: "final".
statusstringEstado del evento: upcoming, live, final o unconfirmed. El estado es live cuando nuestro seguimiento de partidos muestra que el partido está en curso, o cuando varias casas de apuestas ofrecen precios en vivo en él. unconfirmed significa que el feed en vivo dejó de incluir el partido antes de mostrar un estado de fin de partido. El último marcador visto no es un resultado final, is_live es false y no hay completed_at. Entre los endpoints de eventos, solo este devuelve unconfirmed; la lista /events nunca lo hace, y ?status=unconfirmed no es un valor de filtro allí. Live Game State muestra el mismo partido como fila sin confirmar.
is_livebooleanIndica si el partido está en vivo: true cuando status es live.
live_book_countintegerCuántas casas de apuestas tienen al menos un precio en vivo en este evento. Siempre presente, 0 si no hay ninguna. Puede ser mayor que 0 en un evento que no está live. En un evento live, 0 significa que solo nuestro seguimiento de partidos muestra que el partido está en curso.
season_typestring"Preseason" o "Regular Season". Se omite cuando no se conoce: una liga sin calendario de temporada publicado (hoy todas las ligas excepto nba), una fecha fuera del calendario o un evento sin hora de inicio. La ausencia del campo nunca significa temporada regular.
event_groupstringNombre de la cartelera o del torneo que publican las casas de apuestas (p. ej., UFC Fight Night), el mismo valor que en la lista /events. Se omite cuando ninguna casa lo envía, y en algunos eventos terminados.
event_group_slugstringevent_group en forma apta para URL (p. ej., ufc-fight-night). Presente exactamente cuando lo está event_group.
booksarraySportsbooks que cubren este evento, ordenados de forma descendente por número de mercados
marketsarrayTipos de mercado disponibles para este evento, ordenados de forma descendente por número de selecciones
last_seenobjectPresente solo cuando status es unconfirmed y tu clave tiene el complemento Game State o el plan Enterprise. El último marcador que mostró el feed en directo, descrito más abajo.
resultobjectPresente solo cuando status es final y tu clave tiene el complemento Game State o el plan Enterprise. El resultado final, descrito más abajo.
result_accessstringPresente solo cuando status es final o unconfirmed. granted: tu clave recibe result (en final) o last_seen (en unconfirmed). requires_game_state_addon: ese objeto se retiene para tu clave.
sourcestringconfirmed en un evento final cuyo resultado se confirmó después de que el feed en directo dejara de mostrar el partido. Ausente cuando el feed en directo mostró el final del partido.

Array de booksEnlace permanente a esta sección

Cada entrada del array books describe un sportsbook que dispone de cuotas para este evento.

CampoTipoDescripción
idstringIdentificador del sportsbook (p. ej., draftkings, pinnacle)
namestringNombre visible del sportsbook
market_countintegerNúmero de tipos de mercado distintos que ofrece este book para el evento
last_updatestringMarca de tiempo ISO 8601 de la actualización de cuotas más reciente de este book

Array de marketsEnlace permanente a esta sección

Cada entrada del array markets resume un tipo de mercado disponible para este evento.

CampoTipoDescripción
typestringIdentificador del tipo de mercado (p. ej., moneyline, spread, total, player_prop)
selection_countintegerNúmero de selecciones distintas disponibles en este mercado
book_countintegerNúmero de sportsbooks que ofrecen este mercado

Objeto last_seenEnlace permanente a esta sección

Presente solo en un evento unconfirmed, y solo para una clave con el complemento Game State o el plan Enterprise. Sin el complemento, el evento sigue respondiendo status: "unconfirmed", pero sin last_seen. Contiene el último frame que mostró el feed en directo antes de dejar de incluir el partido, por ejemplo 97-81 en Q4 4:59. No es un marcador final; no lo trates como el resultado.

CampoTipoDescripción
home_scoreintegerMarcador del equipo local en el último frame visto. Un número de sets cuando score_type es sets
away_scoreintegerMarcador del equipo visitante en el último frame visto. Un número de sets cuando score_type es sets
score_typestringsets para tenis, tenis de mesa, voleibol y bádminton; points para el resto de deportes
game_periodstringPeriodo en el último frame visto (p. ej., Q4). Se omite cuando el feed no envió ninguno
game_clockstringReloj de juego en el último frame visto (p. ej., 4:59). Se omite cuando el feed no envió ninguno
seen_atstringHora ISO 8601 en que el feed en directo mostró el partido por última vez

Objeto resultEnlace permanente a esta sección

Presente solo en un evento final, y solo para una clave con el complemento Game State o el plan Enterprise. Sin el complemento, el evento sigue respondiendo status: "final" y completed_at, con result_access: "requires_game_state_addon" y sin result. Nunca es null ni se rellena con ceros, así que un result ausente nunca equivale a un 0-0.

CampoTipoDescripción
event_idstringEl identificador del evento
sportstringIdentificador del deporte
leaguestringSlug de la liga
home_teamstringNombre del equipo local
away_teamstringNombre del equipo visitante
final_home_scoreintegerMarcador final del local. Un número de sets cuando score_type es sets
final_away_scoreintegerMarcador final del visitante. Un número de sets cuando score_type es sets
winnerstringhome, away o draw. Se omite cuando no se puede determinar el ganador
score_typestringsets para tenis, tenis de mesa, voleibol y bádminton; points para todos los demás deportes. Se omite en un registro antiguo cuya forma de puntuar no se puede determinar
period_scoresobjectMarcador final por periodo, con clave de etiqueta de periodo (p. ej., Q1, OT, 1H, SETS), cada uno { "home", "away" }. Se omite cuando no hay desglose
event_completed_atstringEl mismo valor que completed_at del evento

Ejemplos de solicitudesEnlace permanente a esta sección

curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208" \ -H "X-API-Key: YOUR_API_KEY"

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección

Las respuestas de un único recurso envuelven el objeto en data como un único objeto (no como un array).

{ "data": { "id": "evt_nba_bos_lal_20260208", "external_ids": { "draftkings": "12345678", "fanduel": "87654321", "pinnacle": "556677889", "betmgm": "ms_44556" }, "sport": "basketball", "league": "NBA", "home_team": "Boston Celtics", "away_team": "Los Angeles Lakers", "start_time": "2026-02-08T19:30:00Z", "status": "upcoming", "is_live": false, "live_book_count": 0, "books": [ { "id": "draftkings", "name": "DraftKings", "market_count": 5, "last_update": "2026-02-08T12:05:00Z" }, { "id": "fanduel", "name": "FanDuel", "market_count": 4, "last_update": "2026-02-08T12:04:30Z" }, { "id": "pinnacle", "name": "Pinnacle", "market_count": 3, "last_update": "2026-02-08T12:03:00Z" }, { "id": "betmgm", "name": "BetMGM", "market_count": 3, "last_update": "2026-02-08T12:02:15Z" } ], "markets": [ { "type": "moneyline", "selection_count": 2, "book_count": 4 }, { "type": "spread", "selection_count": 2, "book_count": 4 }, { "type": "total", "selection_count": 2, "book_count": 3 }, { "type": "player_prop", "selection_count": 18, "book_count": 2 }, { "type": "team_total", "selection_count": 4, "book_count": 1 } ] }, "meta": { "event_id": "evt_nba_bos_lal_20260208" } }

Respuestas de errorEnlace permanente a esta sección

404 Not Found

{ "error": { "code": "not_found", "message": "Event not found", "docs": "https://docs.sharpapi.io/en/api-reference/events-by-id" } }

401 Unauthorized

Si no se envía ninguna clave se devuelve missing_api_key; una clave inválida devuelve invalid_api_key.

{ "error": { "code": "missing_api_key", "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.", "docs": "https://docs.sharpapi.io/en/authentication" } }

Casos de usoEnlace permanente a esta sección

  • Comparación entre books — El id canónico es el mismo en todos los sportsbooks, por lo que todas las cuotas devueltas ya están emparejadas con el mismo evento real. Consulta Emparejamiento de eventos.
  • Análisis de mercado — Consulta todos los tipos de mercado disponibles y cuántos books ofrecen cada uno
  • Referencia sharp — Compara las cuotas de los soft books con las de Pinnacle (el referente sharp)
  • Enlaces directos (deep linking) — Usa external_ids para enviar a los usuarios a la página del evento en un sportsbook concreto

Endpoints relacionadosEnlace permanente a esta sección

Last updated on