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/middles

Autenticación

Requiere API key. Se requiere nivel Pro o superior.

Parámetros de consulta

Ejemplos de solicitud

curl -X GET "https://api.sharpapi.io/api/v1/opportunities/middles?league=nfl&min_size=1" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  'https://api.sharpapi.io/api/v1/opportunities/middles?league=nfl&min_size=1',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
 
for (const middle of data) {
  console.log(`${middle.event_name} [${middle.market_type}]`);
  console.log(`  Middle: ${middle.middle_size} pts, numbers: ${middle.middle_numbers}`);
  console.log(`  EV: $${middle.expected_value}, probability: ${(middle.middle_probability * 100).toFixed(1)}%`);
  if (middle.is_guaranteed_profit) {
    console.log(`  *** GUARANTEED PROFIT: ${middle.guaranteed_roi}% ROI ***`);
  }
  if (middle.key_numbers.length > 0) {
    console.log(`  Key numbers: ${middle.key_numbers} (${(middle.key_number_probability * 100).toFixed(1)}%)`);
  }
}

import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/opportunities/middles',
    params={'league': 'nfl', 'min_size': 1},
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
data = response.json()
 
for middle in data['data']:
    print(f"{middle['event_name']} [{middle['market_type']}]")
    print(f"  Middle: {middle['middle_size']} pts at {middle['middle_numbers']}")
    print(f"  EV: ${middle['expected_value']}, prob: {middle['middle_probability']:.1%}")
    if middle['is_guaranteed_profit']:
        print(f"  *** GUARANTEED PROFIT: {middle['guaranteed_roi']}% ***")

Respuesta

Éxito (200)

{
  "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",
        "line": -2.5,
        "odds": { "american": -110, "decimal": 1.909, "probability": 0.524, "fair_probability": 0.524 },
        "stake_percent": 50.12,
        "odds_age_seconds": 5.0
      },
      "side2": {
        "book": "fanduel",
        "selection": "Buffalo Bills",
        "line": 7.5,
        "odds": { "american": -108, "decimal": 1.926, "probability": 0.519, "fair_probability": 0.519 },
        "stake_percent": 49.88,
        "odds_age_seconds": 12.3
      },
      "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 respuesta

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 296
X-RateLimit-Reset: 1707401000
X-Data-Delay: 0
X-Request-Id: req_mid456abc789

Respuestas de error

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

403 Tier Required

{
  "error": {
    "code": "tier_restricted",
    "message": "Middles detection requires Pro tier or higher",
    "docs": "https://docs.sharpapi.io/en/pricing"
  }
}

Campos de respuesta

Objeto Side

Indicadores de advertencia

Endpoint de detalle

Obtén una única oportunidad de middle por su ID.

GET /api/v1/opportunities/middles/:id

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?

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 spread

DraftKings:  Chiefs -2.5  @ -110
FanDuel:     Bills  +7.5  @ -108

Apuestas:

• Chiefs -2.5 en DraftKings
• Bills +7.5 en FanDuel

Posibles resultados:

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 clave

Algunos deportes tienen incrementos de puntuación que aumentan la distribución de probabilidad:

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)

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 middle

Consideraciones de riesgo

Frescura de las cuotas

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ácticas

1. Céntrate en middles más grandes — Establece min_size en al menos 1.0 para mejores tasas de acierto
2. Vigila los números clave — Los middles que contienen NFL 3/7 o NHL/MLB/soccer 1 tienen tasas de acierto elevadas
3. Prioriza el beneficio garantizado — Filtra por is_guaranteed_profit para encontrar oportunidades sin riesgo
4. Comprueba la frescura de las cuotas — Un odds_age_seconds bajo significa que las líneas son actuales y accionables
5. Combínalo con el endpoint de resumen — Usa /middles/summary para vistas generales de dashboard
6. Actúa con rapidez — Las líneas convergen a medida que los books se ajustan, cerrando la ventana del middle
7. Usa streaming — Suscríbete a los eventos middles:detected mediante SSE o WebSocket para alertas en tiempo real

Endpoints relacionados

• 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:detected y middles:expired en tiempo real
• Mejores Cuotas — Compara cuotas entre todos los books