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ó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 ruta

Parámetro	Tipo	Obligatorio	Descripción
`eventId`	string	Sí	Identificador único del evento (p. ej., `evt_nba_bos_lal_20260208`)

Cabeceras de respuesta

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 evento

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
`status`	string	Estado del evento: `upcoming`, `live`, `final`, `postponed`, `cancelled`
`is_live`	boolean	Indica si el evento está en directo en este momento
`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

Array de books

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 markets

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

Ejemplos de solicitudes

cURL


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

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
const response = await fetch(
  `https://api.sharpapi.io/api/v1/events/${eventId}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`${data.home_team} vs ${data.away_team}`);
console.log(`Markets: ${data.markets.map(m => m.type).join(', ')}`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
event = response.json()['data']
print(f"{event['home_team']} vs {event['away_team']}")
print(f"Markets: {[m['type'] for m in event['markets']]}")

Respuesta

Éxito (200)

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,
    "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 error

404 Not Found


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

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

Casos de uso

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 relacionados

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