Middles
Encuentra oportunidades de middles donde dos sportsbooks tienen líneas diferentes, creando una brecha en la que ambas apuestas pueden ganar.
GET /api/v1/opportunities/middlesAutenticaciónEnlace permanente a esta sección
Requiere API key. Se requiere nivel Pro o superior.
Parámetros de consultaEnlace permanente a esta sección
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
sport | string | todos | Filtrar por deporte(s), separados por comas (p. ej. basketball, football). Solo IDs de deporte; un ID de liga como nba va en league (detalles). |
league | string | todas | Filtrar por liga(s), separadas por comas (p. ej. nba, nfl, nhl) |
sportsbook | string | permitidos por nivel | Filtrar por sportsbook(s), separados por comas. Se aplican los límites de nivel. |
market | string | todos | Filtrar por tipo(s) de mercado, separados por comas (p. ej. point_spread, total_points). Admite alias de categorías — consulta Odds: Alias de Categorías de Mercado. |
min_size | number | 0.5 | Tamaño mínimo del middle en puntos |
is_live | boolean | — | true = solo en vivo, false = solo prepartido, omitir = ambos |
max_odds_age | number | — | Antigüedad máxima de las cuotas en segundos. Filtra oportunidades obsoletas. |
sort | string | quality | Campo de ordenación: quality (por defecto), ev, probability, middle_size, event (hora de inicio), market (id del mercado, orden natural). El prefijo - ordena de forma descendente y + de forma ascendente (en una URL envía %2B: un + suelto se lee como un espacio). Sin prefijo, quality, ev, probability y middle_size van de mejor a peor, y event y market de forma ascendente. Los empates se ordenan por quality (mejor primero) y después por id. Un valor desconocido ordena por quality y se ignora su prefijo. |
limit | integer | 50 | Resultados por página (máx. 200) |
offset | integer | 0 | Desplazamiento de paginación |
Ejemplos de solicitudEnlace permanente a esta sección
cURL
curl -X GET "https://api.sharpapi.io/api/v1/opportunities/middles?league=nfl&min_size=1" \
-H "X-API-Key: YOUR_API_KEY"RespuestaEnlace permanente a esta sección
Éxito (200)Enlace permanente a esta sección
{
"success": true,
"data": [
{
"id": "a1b2c3d4e5f67890",
"event_id": "evt_nfl_buf_kc_20260217",
"event_name": "Buffalo Bills @ Kansas City Chiefs",
"sport": "football",
"league": "nfl",
"market_type": "point_spread",
"home_team": "Kansas City Chiefs",
"away_team": "Buffalo Bills",
"start_time": "2026-02-17T20:00:00Z",
"side1": {
"book": "draftkings",
"selection": "Kansas City Chiefs",
"selection_type": null,
"line": -2.5,
"odds_american": -110, "odds_decimal": 1.909, "odds_probability": 0.524, "fair_probability": 0.524,
"stake_percent": 50.12,
"odds_age_seconds": 5.0,
"deep_link": "https://api.sharpapi.io/api/v1/deeplink/206720022460212?state=pa"
},
"side2": {
"book": "fanduel",
"selection": "Buffalo Bills",
"selection_type": null,
"line": 7.5,
"odds_american": -108, "odds_decimal": 1.926, "odds_probability": 0.519, "fair_probability": 0.519,
"stake_percent": 49.88,
"odds_age_seconds": 12.3,
"deep_link": null
},
"middle_size": 5.0,
"middle_numbers": [3, 4, 5, 6, 7],
"middle_probability": 0.377,
"expected_value": 31.52,
"roi_percentage": 31.52,
"worst_case_loss": -4.13,
"best_case_profit": 83.54,
"break_even_percent": 4.71,
"odds_age_seconds": 12.3,
"is_guaranteed_profit": false,
"guaranteed_roi": null,
"key_numbers": [3, 7],
"key_number_probability": 0.242,
"is_live": false,
"is_player_prop": false,
"player_name": null,
"stat_category": null,
"warnings": ["HIGH_PROBABILITY", "LARGE_GAP"],
"detected_at": "2026-02-17T19:45:30Z"
}
],
"meta": {
"count": 1,
"total": 47,
"source": "cache",
"pagination": {
"limit": 50,
"offset": 0,
"has_more": false,
"next_offset": null
},
"summary": { "count": 47 },
"filters": {
"sport": null,
"league": ["nfl"],
"sportsbook": null,
"market": null,
"min_size": 1
},
"updated_at": "2026-02-17T19:45:30Z"
}
}Cabeceras de respuestaEnlace permanente a esta sección
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 296
X-RateLimit-Reset: 1707401000
X-Data-Delay: 0
X-Request-Id: req_mid456abc789Respuestas de errorEnlace permanente a esta sección
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"
}
}403 Tier Required
{
"error": {
"code": "tier_restricted",
"message": "This endpoint requires Pro tier or higher. Upgrade to Pro for $229/mo: https://sharpapi.io/dashboard/billing/upgrade/pro",
"docs": "https://sharpapi.io/pricing",
"tier": "hobby",
"required_tier": "pro",
"upgrade": "https://sharpapi.io/dashboard/billing/upgrade/pro",
"upgrade_note": "Upgrade to Pro for $229/mo"
}
}Campos de respuestaEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del middle (hash) |
event_id | string | Identificador del evento |
event_name | string | Nombre legible del evento |
sport | string | Identificador del deporte |
league | string | Identificador de la liga |
market_type | string | Tipo de mercado (point_spread, total_points, tipos de player props) |
home_team | string | Nombre del equipo local |
away_team | string | Nombre del equipo visitante |
start_time | string|null | Hora de inicio del partido (ISO 8601) |
side1 | object | Primer lado de la apuesta middle |
side2 | object | Segundo lado de la apuesta middle |
middle_size | number | Tamaño de la brecha del middle en puntos |
middle_numbers | number[] | Valores enteros que harían acertar el middle |
middle_probability | number | Probabilidad estimada de que el middle acierte (específica del deporte) |
expected_value | number | EV en dólares por cada $100 apostados en total |
roi_percentage | number | EV como porcentaje del stake total |
worst_case_loss | number | Pérdida cuando el middle falla (negativo = pérdida) |
best_case_profit | number | Beneficio cuando el middle acierta (ambas apuestas ganan) |
break_even_percent | number | Tasa mínima de aciertos necesaria para no perder |
odds_age_seconds | number|null | Antigüedad de las cuotas subyacentes más obsoletas en el momento de la detección |
is_guaranteed_profit | boolean | True cuando worst_case_loss >= 0 (arb + middle) |
guaranteed_roi | number|null | ROI% en el peor caso cuando está garantizado (null en caso contrario) |
key_numbers | number[] | Números clave dentro del rango del middle (p. ej., NFL 3, 7) |
key_number_probability | number | Probabilidad combinada solo de los números clave |
quality_score | number | Métrica de calidad multifactor (0-100) |
market_overround | number | Probabilidad implícita combinada en ambos lados |
is_live | boolean | Indica si el partido está en vivo: true cuando nuestro seguimiento de partidos muestra que el partido está en curso o, si no, cuando las casas de apuestas que cotizan el partido ofrecen precios en vivo. |
is_player_prop | boolean | Indica si se trata de un middle de player prop |
player_name | string|null | Nombre del jugador (si es player prop) |
stat_category | string|null | Tipo de estadística (si es player prop, p. ej., points, rebounds) |
warnings | string[] | Indicadores de advertencia (ver más abajo) |
detected_at | string | Cuándo se detectó el middle (ISO 8601) |
Objeto SideEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
book | string | Sportsbook para este lado |
selection | string | Nombre de la selección |
selection_type | string|null | Qué lado de un middle de over/under es: "over" en side1 y "under" en side2 para totales, totales de equipo y props de jugador. null en ambos lados de un middle tipo spread (point spread, puck line, game spread, hándicap asiático y de sets, spreads de mitad y de cuarto), donde selection nombra al equipo. Siempre presente. Mismo significado que selection_type en una fila de /odds, limitado aquí a over y under. Lea el lado de este campo, no de selection: selection es la etiqueta propia del sportsbook, que puede ser el nombre del jugador, una etiqueta localizada o Yes/No en un mercado de predicción. |
line | number | Valor de la línea en este sportsbook |
odds_american | number | Cuotas americanas |
odds_decimal | number | Cuotas decimales |
odds_probability | number | Probabilidad implícita (0-1) |
fair_probability | number | Probabilidad justa ajustada por el overround |
stake_percent | number | Asignación recomendada de stake (% del total) |
odds_age_seconds | number|null | Antigüedad de las cuotas de este lado en el momento de la detección |
deep_link | string|null | Dirección de redirección para la apuesta de este lado, https://api.sharpapi.io/api/v1/deeplink/{id}?state=XX — la Redirección de Deep Link, construida igual que el deep_link de una pata de arbitraje. La clave siempre está presente: null cuando el sportsbook no proporcionó enlace. El sufijo ?state= es el parámetro state de la solicitud, pa si se omite. |
Indicadores de advertenciaEnlace permanente a esta sección
| Advertencia | Significado |
|---|---|
HIGH_PROBABILITY | La probabilidad del middle supera el 15% — inusualmente probable que acierte |
LARGE_GAP | El tamaño del middle supera los 3 puntos — verifica que las líneas sean correctas |
STALE_ODDS | Una o ambas cuotas tienen más de 30 segundos |
LIVE_GAME | El partido está actualmente en curso |
GUARANTEED_PROFIT | La pérdida en el peor caso es positiva — esto también es un arbitraje |
Endpoint de detalleEnlace permanente a esta sección
Obtén una única oportunidad de middle por su ID.
GET /api/v1/opportunities/middles/:id| Parámetro | Tipo | Descripción |
|---|---|---|
id | path | Obligatorio. Hash hexadecimal de 16 caracteres (p. ej., a1b2c3d4e5f67890) |
Devuelve un único objeto middle (mismo esquema que los elementos de la lista). Devuelve 404 si no se encuentra y 400 si el formato del ID no es válido.
curl -X GET "https://api.sharpapi.io/api/v1/opportunities/middles/a1b2c3d4e5f67890" \
-H "X-API-Key: YOUR_API_KEY"¿Qué son los middles?Enlace permanente a esta sección
Un middle se produce cuando dos sportsbooks ofrecen líneas diferentes en el mismo mercado, creando una brecha numérica en la que ambas apuestas pueden ganar simultáneamente.
A diferencia del arbitraje (que garantiza beneficio), los middles te dan la oportunidad de ganar ambos lados de una apuesta si el resultado final cae en el “medio” de las dos líneas.
Ejemplo de middle de spreadEnlace permanente a esta sección
DraftKings: Chiefs -2.5 @ -110
FanDuel: Bills +7.5 @ -108Apuestas:
- Chiefs -2.5 en DraftKings
- Bills +7.5 en FanDuel
Posibles resultados:
| Chiefs ganan por | Chiefs -2.5 | Bills +7.5 | Resultado |
|---|---|---|---|
| 1-2 puntos | Pierde | Gana | División (pequeña pérdida) |
| 3, 4, 5, 6 o 7 | Gana | Gana | MIDDLE ACERTADO |
| 8+ puntos | Gana | Pierde | División (pequeña pérdida) |
Si los Chiefs ganan por 3-7, ambas apuestas ganan. Los números 3 y 7 son números clave de la NFL (gol de campo y touchdown), lo que hace que este middle sea especialmente valioso.
Números claveEnlace permanente a esta sección
Algunos deportes tienen incrementos de puntuación que aumentan la distribución de probabilidad:
| Deporte | Números clave | Por qué |
|---|---|---|
| NFL | 3, 7, 10, 14 | Gol de campo (3), touchdown (7), combinaciones |
| NHL | 1 | La mayoría de los partidos se deciden por 1 gol (~47%) |
| MLB | 1 | La mayoría de los partidos se deciden por 1 carrera (~30%) |
| Soccer | 1 | La mayoría de los partidos se deciden por 1 gol (~38%) |
Cuando un middle contiene números clave, los campos key_numbers y key_number_probability lo destacan. Un middle de NFL que abarca el 3 y el 7 tiene una probabilidad combinada de números clave de ~24,2%.
Beneficio garantizado (Arb + Middle)Enlace permanente a esta sección
Cuando is_guaranteed_profit es true, el middle también es un arbitraje — el peor caso aún produce beneficio. Este es el tipo de middle más raro y valioso. El campo guaranteed_roi muestra el retorno mínimo incluso si el middle falla.
Guía de tamaño del middleEnlace permanente a esta sección
| Tamaño del middle | Calidad | Mercados típicos |
|---|---|---|
| 0,5 puntos | Estrecho | Oportunidades raras, baja tasa de acierto |
| 1,0 puntos | Estándar | Común en spreads y totales |
| 1,5 - 2,0 puntos | Bueno | Búscalos activamente |
| 2,5+ puntos | Excelente | Poco frecuentes pero muy rentables |
Usa min_size=1 para filtrar middles estrechos. Los middles más grandes tienen mayor probabilidad de caer dentro de la brecha, lo que los hace más rentables de forma consistente a lo largo del tiempo.
Consideraciones de riesgoEnlace permanente a esta sección
Los middles no están libres de riesgo como el arbitraje (a menos que is_guaranteed_profit sea true). Cuando el resultado cae fuera del middle, pierdes el vig del lado perdedor (normalmente entre el 4-5% de una pata). Sin embargo, cuando un middle acierta, ganas ambas apuestas, lo que compensa con creces a lo largo del tiempo.
Frescura de las cuotasEnlace permanente a esta sección
El campo odds_age_seconds muestra la antigüedad de las cuotas subyacentes cuando se detectó el middle. Cada lado también tiene su propio odds_age_seconds. Si cualquiera de los lados supera los 30 segundos, se añade la advertencia STALE_ODDS. Las cuotas obsoletas pueden haberse movido ya — actúa con rapidez sobre las oportunidades frescas.
Buenas prácticasEnlace permanente a esta sección
- Céntrate en middles más grandes — Establece
min_sizeen al menos 1.0 para mejores tasas de acierto - Vigila los números clave — Los middles que contienen NFL 3/7 o NHL/MLB/soccer 1 tienen tasas de acierto elevadas
- Prioriza el beneficio garantizado — Filtra por
is_guaranteed_profitpara encontrar oportunidades sin riesgo - Comprueba la frescura de las cuotas — Un
odds_age_secondsbajo significa que las líneas son actuales y accionables - Combínalo con el endpoint de resumen — Usa
/middles/summarypara vistas generales de dashboard - Actúa con rapidez — Las líneas convergen a medida que los books se ajustan, cerrando la ventana del middle
- Usa streaming — Suscríbete a los eventos
middles:detectedmediante SSE o WebSocket para alertas en tiempo real
Endpoints relacionadosEnlace permanente a esta sección
- Resumen de Middles — Estadísticas agregadas sin la lista completa
- Oportunidades +EV — Apuestas de valor esperado positivo
- Oportunidades de Arbitraje — Oportunidades de beneficio garantizado
- Stream SSE — Eventos
middles:detectedymiddles:expireden tiempo real - Mejores Cuotas — Compara cuotas entre todos los books