Resumen de Middles

Obtén estadísticas agregadas de las oportunidades de middles actuales sin la lista completa. Utiliza los mismos datos subyacentes que el endpoint Middles.


GET /api/v1/opportunities/middles/summary

AutenticaciónPermalink for this section

Requiere API key. Se requiere nivel Pro o superior.

Parámetros de ConsultaPermalink for this section

Parámetro	Tipo	Por defecto	Descripción
`sport`	string	all	Filtrar por deporte (p. ej., `basketball`, `football`)
`league`	string	all	Filtrar por liga (p. ej., `nba`, `nfl`, `nhl`)

Ejemplos de SolicitudesPermalink for this section

cURL


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

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/opportunities/middles/summary?league=nfl',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
 
console.log(`Total middles: ${data.total}`);
console.log(`Positive EV: ${data.positive_ev_count}`);
console.log(`Guaranteed profit: ${data.guaranteed_profit_count}`);
console.log(`With key numbers: ${data.has_key_numbers_count}`);
console.log(`Avg EV: $${data.avg_ev}, Avg probability: ${(data.avg_probability * 100).toFixed(1)}%`);
 
if (data.best_ev) {
  console.log(`Best EV: $${data.best_ev.ev} (${data.best_ev.sport} ${data.best_ev.market})`);
}
 
console.log('By sport:', data.by_sport);
console.log('By market:', data.by_market);
console.log('By sportsbook:', data.by_sportsbook);

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/opportunities/middles/summary',
    params={'league': 'nfl'},
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
result = response.json()
data = result['data']
 
print(f"Total middles: {data['total']}")
print(f"Positive EV: {data['positive_ev_count']}")
print(f"Guaranteed profit: {data['guaranteed_profit_count']}")
print(f"With key numbers: {data['has_key_numbers_count']}")
print(f"Avg EV: ${data['avg_ev']}, Avg size: {data['avg_middle_size']} pts")
 
if data['best_ev']:
    print(f"Best EV: ${data['best_ev']['ev']} ({data['best_ev']['sport']} {data['best_ev']['market']})")

RespuestaPermalink for this section

Éxito (200)Permalink for this section


{
  "success": true,
  "data": {
    "total": 47,
    "positive_ev_count": 38,
    "guaranteed_profit_count": 2,
    "player_prop_count": 12,
    "by_sport": {
      "football": 18,
      "basketball": 15,
      "hockey": 8,
      "baseball": 6
    },
    "by_market": {
      "point_spread": 22,
      "total_points": 13,
      "player_points": 7,
      "player_rebounds": 5
    },
    "by_sportsbook": {
      "draftkings": 34,
      "fanduel": 31,
      "betmgm": 22,
      "caesars": 18,
      "bet365": 15
    },
    "avg_middle_size": 1.8,
    "avg_probability": 0.1245,
    "avg_ev": 4.72,
    "best_ev": {
      "ev": 31.52,
      "sport": "football",
      "market": "point_spread"
    },
    "has_key_numbers_count": 14
  },
  "meta": {
    "source": "cache",
    "filters": {
      "sport": null,
      "league": ["nfl"]
    },
    "updated_at": "2026-02-17T19:45:30Z"
  }
}

Cabeceras de RespuestaPermalink for this section


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

Respuestas de ErrorPermalink for this section

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 RespuestaPermalink for this section

Campo	Tipo	Descripción
`total`	integer	Número total de middles actuales
`positive_ev_count`	integer	Middles con valor esperado positivo
`guaranteed_profit_count`	integer	Middles que también son oportunidades de arbitraje
`player_prop_count`	integer	Middles en mercados de props de jugadores
`by_sport`	object	Recuento de middles por deporte
`by_market`	object	Recuento de middles por tipo de mercado
`by_sportsbook`	object	Recuento de middles por sportsbook (cada casa de un middle se cuenta)
`avg_middle_size`	number	Tamaño medio del hueco del middle en puntos
`avg_probability`	number	Probabilidad media de que los middles acierten
`avg_ev`	number	Valor esperado medio por cada $100 apostados
`best_ev`	object\|null	Resumen de la oportunidad con mayor EV
`best_ev.ev`	number	EV en dólares por cada $100 apostados
`best_ev.sport`	string	Deporte del middle con mayor EV
`best_ev.market`	string	Tipo de mercado del middle con mayor EV
`has_key_numbers_count`	integer	Middles que contienen números clave específicos del deporte

Casos de UsoPermalink for this section

Resumen del PanelPermalink for this section

Utiliza el endpoint de resumen para alimentar widgets del panel que muestren los conteos de oportunidades de middles, los desgloses y los promedios sin recuperar la lista completa.

Sondeo vs. Recuperación CompletaPermalink for this section

Sondea el endpoint de resumen a intervalos más cortos para detectar cuándo aparecen nuevas oportunidades, y solo recupera el endpoint completo de Middles cuando cambie el conteo.


// Poll summary every 10 seconds
let lastCount = 0;
setInterval(async () => {
  const summary = await fetchMiddlesSummary();
  if (summary.data.total !== lastCount) {
    lastCount = summary.data.total;
    const middles = await fetchMiddles(); // Full fetch
    updateUI(middles);
  }
}, 10000);

El endpoint de resumen está cacheado durante 10 segundos y cuenta para tu rate limit igual que el endpoint completo de middles.

Endpoints RelacionadosPermalink for this section

Middles — Lista completa de oportunidades de middles
Oportunidades +EV — Apuestas con valor esperado positivo
Oportunidades de Arbitraje — Oportunidades de beneficio garantizado
Stream SSE — Eventos en tiempo real middles:detected y middles:expired