Skip to Content
Referencia de la APICuotas por lotes

Cuotas por Lotes

Obtén cuotas de varios eventos en una sola petición. Esto evita realizar llamadas a la API independientes para cada evento, reduciendo la latencia y el consumo del rate limit.

POST /api/v1/odds/batch

AutenticaciónEnlace permanente a esta sección

Requiere API key. Disponible en todos los planes.

Cuerpo de la PeticiónEnlace permanente a esta sección

Envía un cuerpo JSON con los siguientes campos:

CampoTipoObligatorioDescripción
event_idsstring[]SíArray de IDs de eventos para los que se obtendrán las cuotas
sportsbookstringNoFiltro de un único ID de sportsbook (por defecto, todos los disponibles según tu plan)
marketstringNoFiltro de un único tipo de mercado (por defecto, todos)

Límites de Lote por PlanEnlace permanente a esta sección

El número máximo de eventos por petición de lote depende de tu plan:

PlanMáx. Eventos por Lote
Free10
Hobby10
Pro50
Sharp50
Enterprise100

Superar el límite de lote de tu plan devolverá un error 400 validation_error. Divide las peticiones grandes en varios lotes si es necesario.

Ejemplos de PeticiónEnlace permanente a esta sección

curl -X POST "https://api.sharpapi.io/api/v1/odds/batch" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "event_ids": ["evt_nba_lal_bos_20260126", "evt_nba_gsw_mia_20260126"], "sportsbook": "draftkings", "market": "moneyline" }'

RespuestaEnlace permanente a esta sección

Éxito (200)Enlace permanente a esta sección

{ "success": true, "data": { "events": [ { "event_id": "evt_nba_lal_bos_20260126", "event_name": "Los Angeles Lakers @ Boston Celtics", "sport": "basketball", "league": "nba", "start_time": "2026-01-26T19:30:00Z", "is_live": false, "odds": [ { "sportsbook": "draftkings", "market_type": "moneyline", "selection": "Boston Celtics", "selection_type": "home", "odds_american": -210, "odds_decimal": 1.476, "line": null, "timestamp": "2026-01-26T10:15:00.000Z", "price_updated_at": "2026-01-26T09:58:47.000Z" }, { "sportsbook": "draftkings", "market_type": "moneyline", "selection": "Los Angeles Lakers", "selection_type": "away", "odds_american": 175, "odds_decimal": 2.75, "line": null, "timestamp": "2026-01-26T10:15:00.000Z", "price_updated_at": "2026-01-26T09:58:47.000Z" } ] }, { "event_id": "evt_nba_gsw_mia_20260126", "event_name": "Golden State Warriors @ Miami Heat", "sport": "basketball", "league": "nba", "start_time": "2026-01-26T20:00:00Z", "is_live": false, "odds": [ { "sportsbook": "draftkings", "market_type": "moneyline", "selection": "Miami Heat", "selection_type": "home", "odds_american": -130, "odds_decimal": 1.769, "line": null, "timestamp": "2026-01-26T10:15:05.000Z", "price_updated_at": "2026-01-26T10:03:12.000Z" } ] } ], "missing_events": [] }, "meta": { "requested": 2, "found": 2, "missing": 0, "max_batch": 50, "filters": { "sportsbook": "draftkings", "market": "moneyline" }, "updated_at": "2026-01-26T10:15:05.000Z" } }

Cabeceras de RespuestaEnlace permanente a esta sección

X-RateLimit-Limit: 300 X-RateLimit-Remaining: 296 X-RateLimit-Reset: 1737853200 X-Data-Delay: 0 X-Request-Id: req_batch_abc123

Respuestas de ErrorEnlace permanente a esta sección

400 Límite de Lote Superado

{ "error": { "code": "validation_error", "message": "Batch limit exceeded. Your tier (hobby) allows 10 events per batch, but 25 were requested.", "docs": "https://docs.sharpapi.io/en/api-reference/odds-batch" } }

400 Campo de Eventos Faltante

{ "error": { "code": "validation_error", "message": "The 'event_ids' field is required and must be a non-empty array of event IDs.", "docs": "https://docs.sharpapi.io/en/api-reference/odds-batch" } }

401 No Autorizado

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" } }

Estructura de la RespuestaEnlace permanente a esta sección

La respuesta del lote anida los eventos y los IDs faltantes bajo data, con los conteos en meta:

Objeto DataEnlace permanente a esta sección

CampoTipoDescripción
data.eventsEventOdds[]Array de objetos de evento con cuotas anidadas
data.missing_eventsstring[]IDs de eventos que no se encontraron o no tenían cuotas

Objeto MetaEnlace permanente a esta sección

CampoTipoDescripción
meta.requestedintegerNúmero de IDs de eventos en tu petición
meta.foundintegerNúmero de eventos que tenían datos de cuotas
meta.missingintegerNúmero de eventos no encontrados
meta.max_batchintegerTamaño máximo de lote para tu plan
meta.filtersobjectFiltros aplicados (sportsbook, market)

Si un ID de evento de tu petición no tiene cuotas (por ejemplo, el evento ha terminado o no existe), aparecerá en data.missing_events en lugar de provocar un error. La respuesta seguirá incluyendo las cuotas de todos los eventos válidos.

Esquema de la RespuestaEnlace permanente a esta sección

Cada elemento del array data.events es un objeto de evento con cuotas anidadas:

Objeto EventEnlace permanente a esta sección

CampoTipoDescripción
event_idstringIdentificador del evento
event_namestringNombre legible del evento
sportstringSlug del deporte
leaguestringSlug de la liga
start_timestringHora de inicio del evento en ISO 8601
is_livebooleanIndica si alguno de los precios de odds está en vivo. Para el estado del propio partido, usa status en /events.
game_stateobject | undefinedEstado del juego en directo (solo para eventos en directo con marcador)
oddsarrayArray de cuotas para este evento

Objeto Odds (anidado en el evento)Enlace permanente a esta sección

CampoTipoDescripción
sportsbookstringID del sportsbook
market_typestringTipo de mercado
selectionstringNombre de la selección
selection_typestringhome, away, over, under
odds_americannumberCuotas americanas
odds_decimalnumberCuotas decimales
linenumber | nullValor de la línea
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.

Casos de UsoEnlace permanente a esta sección

Carga de Cuotas Pre-partidoEnlace permanente a esta sección

Carga las cuotas de toda la jornada del día en una sola llamada en lugar de hacer decenas de peticiones individuales:

# Get all NBA event IDs from the events endpoint events_response = requests.get( 'https://api.sharpapi.io/api/v1/events', params={'league': 'nba', 'limit': 50}, headers={'X-API-Key': 'YOUR_API_KEY'} ) event_ids = [e['id'] for e in events_response.json()['data']] # Batch fetch all odds at once odds_response = requests.post( 'https://api.sharpapi.io/api/v1/odds/batch', headers={'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json'}, json={'event_ids': event_ids} )

Refresco del DashboardEnlace permanente a esta sección

Refresca periódicamente las cuotas de los eventos que un usuario está siguiendo:

async function refreshWatchlist(eventIds) { const response = await fetch('https://api.sharpapi.io/api/v1/odds/batch', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ event_ids: eventIds }) }); const { data, meta } = await response.json(); if (data.missing_events.length > 0) { console.warn('Missing events:', data.missing_events); } return data.events; }

Endpoints RelacionadosEnlace permanente a esta sección

  • Snapshot de Cuotas - Obtén cuotas con filtros de consulta flexibles
  • Mejores Cuotas - Obtén las mejores cuotas entre books por selección
  • Eventos - Lista los eventos para obtener los IDs de evento para peticiones por lotes
Last updated on