Skip to Content
Referencia de la APICuotas del evento

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}/odds

Este 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ámetroTipoObligatorioDescripción
eventIdstringSíIdentificador único del evento (p. ej., evt_nba_bos_lal_20260208)

Parámetros de ConsultaEnlace permanente a esta sección

ParámetroTipoPor defectoDescripción
sportsbookstringallFiltrar por sportsbook. Separados por comas para varios (p. ej., draftkings,pinnacle)
marketstringallFiltrar por tipo de mercado. Separados por comas para varios (p. ej., moneyline,spread)
limitinteger50Resultados por página (máximo 200)
offsetinteger0Desplazamiento de paginación

Cabeceras de RespuestaEnlace permanente a esta sección

Todas las respuestas incluyen las cabeceras estándar de rate limit y metadatos:

CabeceraDescripción
X-RateLimit-LimitMá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 reinicia la ventana del rate limit
X-Data-DelayRetardo de datos para tu plan (p. ej., 0s, 60s)
X-Request-IdIdentificador único de la solicitud para depuración

Objeto OddsEnlace permanente a esta sección

CampoTipoDescripción
idstringIdentificador único de la cuota
sportsbookstringIdentificador del sportsbook (p. ej., draftkings, pinnacle)
event_idstringIdentificador del evento padre
market_typestringTipo de mercado: moneyline, spread, total, player_prop, etc.
selectionstringLa selección (nombre del equipo, nombre del jugador, Over/Under)
selection_typestringhome, away, over, under
linenumber | nullValor de la línea para mercados de spread/total, null para moneyline
odds.americannumberCuotas americanas (p. ej., -110, +150)
odds.decimalnumberCuotas decimales (p. ej., 1.909)
odds.probabilitynumberProbabilidad implícita (p. ej., 0.5238)
timestampstringHora 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_atstring|undefinedHora 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 -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 -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

# 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