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/batchAutenticació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:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
event_ids | string[] | Sí | Array de IDs de eventos para los que se obtendrán las cuotas |
sportsbook | string | No | Filtro de un único ID de sportsbook (por defecto, todos los disponibles según tu plan) |
market | string | No | Filtro 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:
| Plan | Máx. Eventos por Lote |
|---|---|
| Free | 10 |
| Hobby | 10 |
| Pro | 50 |
| Sharp | 50 |
| Enterprise | 100 |
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
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_abc123Respuestas 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
| Campo | Tipo | Descripción |
|---|---|---|
data.events | EventOdds[] | Array de objetos de evento con cuotas anidadas |
data.missing_events | string[] | IDs de eventos que no se encontraron o no tenían cuotas |
Objeto MetaEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
meta.requested | integer | Número de IDs de eventos en tu petición |
meta.found | integer | Número de eventos que tenían datos de cuotas |
meta.missing | integer | Número de eventos no encontrados |
meta.max_batch | integer | Tamaño máximo de lote para tu plan |
meta.filters | object | Filtros 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
| Campo | Tipo | Descripción |
|---|---|---|
event_id | string | Identificador del evento |
event_name | string | Nombre legible del evento |
sport | string | Slug del deporte |
league | string | Slug de la liga |
start_time | string | Hora de inicio del evento en ISO 8601 |
is_live | boolean | Indica si alguno de los precios de odds está en vivo. Para el estado del propio partido, usa status en /events. |
game_state | object | undefined | Estado del juego en directo (solo para eventos en directo con marcador) |
odds | array | Array de cuotas para este evento |
Objeto Odds (anidado en el evento)Enlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
sportsbook | string | ID del sportsbook |
market_type | string | Tipo de mercado |
selection | string | Nombre de la selección |
selection_type | string | home, away, over, under |
odds_american | number | Cuotas americanas |
odds_decimal | number | Cuotas decimales |
line | number | null | Valor de la línea |
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. |
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