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={eventId}. Ambos devuelven los mismos datos; utiliza el que mejor se adapte a la estructura de tu URL.

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`)

Parámetros de Consulta

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 Respuesta

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 Odds

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)
`last_seen_at`	string	Marca de tiempo ISO 8601 cuando nuestro pipeline observó esta fila por última vez. Úsala como señal de frescura del pipeline.
`odds_changed_at`	string	Marca de tiempo ISO 8601 del momento en que el precio, la línea o el indicador `is_live` cambió realmente por última vez. La proporciona el sportsbook cuando está disponible; en Pinnacle se mantiene a lo largo de actualizaciones sin cambios — consulta Comprender el `odds_changed_at` de Pinnacle.

Ejemplos de Solicitudes

Obtener todas las cuotas de un evento

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds" \
  -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}/odds`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`${meta.total} total odds for this event`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
print(f"{result['meta']['total']} total odds for this event")

Filtrar por sportsbook y mercado

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"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
const response = await fetch(
  `https://api.sharpapi.io/api/v1/events/${eventId}/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
response = requests.get(
    f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
    params={
        'sportsbook': 'draftkings,pinnacle',
        'market': 'moneyline,spread'
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
odds = response.json()['data']

Paginar todas las cuotas

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"

JavaScript


const eventId = 'evt_nba_bos_lal_20260208';
let offset = 0;
const limit = 50;
let allOdds = [];
 
while (true) {
  const response = await fetch(
    `https://api.sharpapi.io/api/v1/events/${eventId}/odds?limit=${limit}&offset=${offset}`,
    { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
  );
  const { data, meta } = await response.json();
  allOdds = allOdds.concat(data);
 
  if (!meta.pagination.has_more) break;
  offset = meta.pagination.next_offset;
}
 
console.log(`Fetched all ${allOdds.length} odds`);

Python


import requests
 
event_id = 'evt_nba_bos_lal_20260208'
all_odds = []
offset = 0
limit = 50
 
while True:
    response = requests.get(
        f'https://api.sharpapi.io/api/v1/events/{event_id}/odds',
        params={'limit': limit, 'offset': offset},
        headers={'X-API-Key': 'YOUR_API_KEY'}
    )
    result = response.json()
    all_odds.extend(result['data'])
 
    if not result['meta']['pagination']['has_more']:
        break
    offset = result['meta']['pagination']['next_offset']
 
print(f"Fetched all {len(all_odds)} odds")

Respuesta

Éxito (200)


{
  "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
      },
      "last_seen_at": "2026-02-08T12:05:00Z"
    },
    {
      "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
      },
      "last_seen_at": "2026-02-08T12:05:00Z"
    },
    {
      "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
      },
      "last_seen_at": "2026-02-08T12:03:00Z"
    },
    {
      "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
      },
      "last_seen_at": "2026-02-08T12:05:00Z"
    },
    {
      "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
      },
      "last_seen_at": "2026-02-08T12:05:00Z"
    }
  ],
  "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 Error

404 Not Found


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

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "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 Relacionados

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