Cuotas de Evento
Obtén todas las cuotas de un evento específico con filtrado opcional por sportsbook y tipo de mercado. Devuelve una lista paginada de entradas de cuotas.
GET /api/v1/events/{eventId}/oddsEste es un endpoint de conveniencia equivalente a GET /api/v1/odds?event_id={eventId}. Ambos devuelven los mismos datos; utiliza el que mejor se adapte a la estructura de tu URL.
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) |
Parámetros de ConsultaEnlace permanente a esta sección
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
sportsbook | string | all | Filtrar por sportsbook. Separados por comas para varios (p. ej., draftkings,pinnacle) |
market | string | all | Filtrar por tipo de mercado. Separados por comas para varios (p. ej., moneyline,spread) |
limit | integer | 50 | Resultados por página (máximo 200) |
offset | integer | 0 | Desplazamiento de paginación |
Cabeceras de RespuestaEnlace permanente a esta sección
Todas las respuestas incluyen las cabeceras estándar de rate limit y metadatos:
| Cabecera | Descripción |
|---|---|
X-RateLimit-Limit | 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 reinicia la ventana del rate limit |
X-Data-Delay | Retardo de datos para tu plan (p. ej., 0s, 60s) |
X-Request-Id | Identificador único de la solicitud para depuración |
Objeto OddsEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único de la cuota |
sportsbook | string | Identificador del sportsbook (p. ej., draftkings, pinnacle) |
event_id | string | Identificador del evento padre |
market_type | string | Tipo de mercado: moneyline, spread, total, player_prop, etc. |
selection | string | La selección (nombre del equipo, nombre del jugador, Over/Under) |
selection_type | string | home, away, over, under |
line | number | null | Valor de la línea para mercados de spread/total, null para moneyline |
odds.american | number | Cuotas americanas (p. ej., -110, +150) |
odds.decimal | number | Cuotas decimales (p. ej., 1.909) |
odds.probability | number | Probabilidad implícita (p. ej., 0.5238) |
timestamp | string | Hora ISO 8601 en que SharpAPI refrescó por última vez esta cuota a través de su pipeline — avanza en cada ciclo de ingesta. Es una señal de frescura del feed / actividad; NO es cuándo cambió el precio por última vez. Consulta Entendiendo el campo timestamp. |
price_updated_at | string|undefined | Hora ISO 8601 en que se actualizó por última vez el precio de esta cuota. Se mueve cuando cambian el precio, la línea, el estado en vivo, la suspensión, el libro de órdenes o el tamaño disponible, no cuando SharpAPI vuelve a leer una fila sin cambios. Se omite cuando la fila no tiene hora de cambio. Consulta Entendiendo el campo timestamp. |
Ejemplos de SolicitudesEnlace permanente a esta sección
Obtener todas las cuotas de un eventoEnlace permanente a esta sección
cURL
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds" \
-H "X-API-Key: YOUR_API_KEY"Filtrar por sportsbook y mercadoEnlace permanente a esta sección
cURL
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread" \
-H "X-API-Key: YOUR_API_KEY"Paginar todas las cuotasEnlace permanente a esta sección
cURL
# First page
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=0" \
-H "X-API-Key: YOUR_API_KEY"
# Next page
curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=50" \
-H "X-API-Key: YOUR_API_KEY"RespuestaEnlace permanente a esta sección
Éxito (200)Enlace permanente a esta sección
{
"data": [
{
"id": "dk_evt_nba_bos_lal_20260208_ml_home",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"market_type": "moneyline",
"selection": "Boston Celtics",
"selection_type": "home",
"line": null,
"odds": {
"american": -180,
"decimal": 1.556,
"odds_probability": 0.643
},
"timestamp": "2026-02-08T12:05:00Z",
"price_updated_at": "2026-02-08T11:41:23Z"
},
{
"id": "dk_evt_nba_bos_lal_20260208_ml_away",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"market_type": "moneyline",
"selection": "Los Angeles Lakers",
"selection_type": "away",
"line": null,
"odds": {
"american": 155,
"decimal": 2.55,
"odds_probability": 0.392
},
"timestamp": "2026-02-08T12:05:00Z",
"price_updated_at": "2026-02-08T11:41:23Z"
},
{
"id": "pin_evt_nba_bos_lal_20260208_ml_home",
"sportsbook": "pinnacle",
"event_id": "evt_nba_bos_lal_20260208",
"market_type": "moneyline",
"selection": "Boston Celtics",
"selection_type": "home",
"line": null,
"odds": {
"american": -175,
"decimal": 1.571,
"odds_probability": 0.636
},
"timestamp": "2026-02-08T12:03:00Z",
"price_updated_at": "2026-02-08T10:17:45Z"
},
{
"id": "dk_evt_nba_bos_lal_20260208_spread_home",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"market_type": "spread",
"selection": "Boston Celtics",
"selection_type": "home",
"line": -6.5,
"odds": {
"american": -110,
"decimal": 1.909,
"odds_probability": 0.524
},
"timestamp": "2026-02-08T12:05:00Z",
"price_updated_at": "2026-02-08T11:41:23Z"
},
{
"id": "dk_evt_nba_bos_lal_20260208_total_over",
"sportsbook": "draftkings",
"event_id": "evt_nba_bos_lal_20260208",
"market_type": "total",
"selection": "Over",
"selection_type": "over",
"line": 224.5,
"odds": {
"american": -110,
"decimal": 1.909,
"odds_probability": 0.524
},
"timestamp": "2026-02-08T12:05:00Z",
"price_updated_at": "2026-02-08T11:41:23Z"
}
],
"meta": {
"count": 5,
"total": 48,
"pagination": {
"limit": 50,
"offset": 0,
"has_more": false,
"next_offset": null
},
"updated_at": "2026-02-08T12:05:00Z",
"filters": {
"sportsbook": "all",
"market": "all"
}
}
}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-odds"
}
}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"
}
}429 Rate Limited
{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Upgrade your tier for higher limits.",
"docs": "https://docs.sharpapi.io/en/pricing"
}
}Endpoints RelacionadosEnlace permanente a esta sección
- Events - Listar y buscar eventos
- Event Details - Obtener detalles del evento con datos de mercado integrados
- Event Markets - Listar tipos de mercado disponibles para un evento
- Odds Snapshot - Obtener cuotas de todos los eventos
- Best Odds - Obtener las mejores cuotas en todos los sportsbooks
Last updated on