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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
eventId | string | Sí | 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:
| Cabecera | Descripción |
|---|---|
X-RateLimit-Limit | Número máximo de solicitudes por minuto para tu plan |
X-RateLimit-Remaining | Solicitudes restantes en la ventana actual |
X-RateLimit-Reset | Marca de tiempo Unix en la que se restablece la ventana de rate limit |
X-Data-Delay | Retardo de los datos para tu plan (p. ej., 0s, 60s) |
X-Request-Id | Identificador único de la solicitud, útil para depuración |
Objeto de detalle del eventoEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador 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_ids | object | Mapa 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. |
sport | string | Identificador del deporte (p. ej., basketball, football) |
league | string | Nombre de la liga (p. ej., NBA, NFL) |
home_team | string | Nombre del equipo local |
away_team | string | Nombre del equipo visitante |
start_time | string | Hora 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_at | string | Hora de finalización en ISO 8601. Presente solo en filas con status: "final". |
status | string | Estado 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_live | boolean | Indica si el partido está en vivo: true cuando status es live. |
live_book_count | integer | Cuá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_type | string | "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_group | string | Nombre 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_slug | string | event_group en forma apta para URL (p. ej., ufc-fight-night). Presente exactamente cuando lo está event_group. |
books | array | Sportsbooks que cubren este evento, ordenados de forma descendente por número de mercados |
markets | array | Tipos de mercado disponibles para este evento, ordenados de forma descendente por número de selecciones |
last_seen | object | Presente 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. |
result | object | Presente 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_access | string | Presente 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. |
source | string | confirmed 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.
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador del sportsbook (p. ej., draftkings, pinnacle) |
name | string | Nombre visible del sportsbook |
market_count | integer | Número de tipos de mercado distintos que ofrece este book para el evento |
last_update | string | Marca 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.
| Campo | Tipo | Descripción |
|---|---|---|
type | string | Identificador del tipo de mercado (p. ej., moneyline, spread, total, player_prop) |
selection_count | integer | Número de selecciones distintas disponibles en este mercado |
book_count | integer | Nú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.
| Campo | Tipo | Descripción |
|---|---|---|
home_score | integer | Marcador del equipo local en el último frame visto. Un número de sets cuando score_type es sets |
away_score | integer | Marcador del equipo visitante en el último frame visto. Un número de sets cuando score_type es sets |
score_type | string | sets para tenis, tenis de mesa, voleibol y bádminton; points para el resto de deportes |
game_period | string | Periodo en el último frame visto (p. ej., Q4). Se omite cuando el feed no envió ninguno |
game_clock | string | Reloj de juego en el último frame visto (p. ej., 4:59). Se omite cuando el feed no envió ninguno |
seen_at | string | Hora 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.
| Campo | Tipo | Descripción |
|---|---|---|
event_id | string | El identificador del evento |
sport | string | Identificador del deporte |
league | string | Slug de la liga |
home_team | string | Nombre del equipo local |
away_team | string | Nombre del equipo visitante |
final_home_score | integer | Marcador final del local. Un número de sets cuando score_type es sets |
final_away_score | integer | Marcador final del visitante. Un número de sets cuando score_type es sets |
winner | string | home, away o draw. Se omite cuando no se puede determinar el ganador |
score_type | string | sets 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_scores | object | Marcador 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_at | string | El mismo valor que completed_at del evento |
Ejemplos de solicitudesEnlace permanente a esta sección
cURL
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
idcanó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_idspara enviar a los usuarios a la página del evento en un sportsbook concreto
Endpoints relacionadosEnlace permanente a esta sección
- Eventos - Lista y busca eventos
- Cuotas del evento - Obtén las cuotas paginadas de este evento
- Mercados del evento - Obtén los tipos de mercado disponibles para este evento
- Snapshot de cuotas - Obtén las cuotas actuales de todos los eventos