Middles

Encontre oportunidades de middles onde dois sportsbooks têm linhas diferentes, criando uma lacuna em que ambas as apostas podem vencer.

GET /api/v1/opportunities/middles

Autenticação

Requer API key. Tier Pro ou superior obrigatório.

Parâmetros de Query

Exemplos de Requisição

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']}% ***")

Resposta

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

Cabeçalhos da Resposta

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

Respostas de Erro

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 da Resposta

Objeto Side

Sinalizadores de Aviso

Endpoint de Detalhe

Busca uma única oportunidade de middle pelo seu ID.

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

Retorna um único objeto middle (mesmo schema dos itens da lista). Retorna 404 se não encontrado, 400 se o formato do ID for inválido.

curl -X GET "https://api.sharpapi.io/api/v1/opportunities/middles/a1b2c3d4e5f67890" \
  -H "X-API-Key: YOUR_API_KEY"

O Que São Middles?

Um middle ocorre quando dois sportsbooks oferecem linhas diferentes no mesmo mercado, criando uma lacuna numérica em que ambas as apostas podem vencer simultaneamente.

Diferente da arbitragem (que garante lucro), os middles dão a você uma chance de vencer ambos os lados de uma aposta se o resultado final cair no “meio” das duas linhas.

Exemplo de Middle de Spread

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

Você aposta:

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

Resultados possíveis:

Se os Chiefs vencerem por 3-7, ambas as apostas vencem. Os números 3 e 7 são números-chave da NFL (field goal e touchdown), tornando este middle especialmente valioso.

Números-Chave

Certos esportes têm incrementos de pontuação que aumentam a distribuição de probabilidade:

Quando um middle contém números-chave, os campos key_numbers e key_number_probability destacam isso. Um middle da NFL abrangendo 3 e 7 tem uma probabilidade combinada de números-chave de ~24,2%.

Lucro Garantido (Arb + Middle)

Quando is_guaranteed_profit é verdadeiro, o middle também é uma arbitragem — o pior caso ainda gera lucro. Este é o tipo mais raro e mais valioso de middle. O campo guaranteed_roi mostra o retorno mínimo mesmo se o middle errar.

Guia de Tamanho do Middle

Considerações de Risco

Atualidade das Odds

O campo odds_age_seconds mostra quão antigas eram as odds subjacentes quando o middle foi detectado. Cada lado também tem seu próprio odds_age_seconds. Se algum dos lados exceder 30 segundos, o aviso STALE_ODDS é adicionado. Odds desatualizadas podem já ter se movido — aja rapidamente em oportunidades novas.

Boas Práticas

1. Foque em middles maiores — Defina min_size para pelo menos 1.0 para melhores taxas de acerto
2. Fique atento a números-chave — Middles contendo 3/7 da NFL ou 1 de NHL/MLB/futebol têm taxas de acerto elevadas
3. Priorize lucro garantido — Filtre por is_guaranteed_profit para encontrar oportunidades sem risco
4. Verifique a atualidade das odds — odds_age_seconds baixo significa que as linhas estão atuais e acionáveis
5. Combine com o endpoint de resumo — Use /middles/summary para visões gerais de dashboard
6. Aja rapidamente — As linhas convergem conforme os books se ajustam, fechando a janela do middle
7. Use streaming — Inscreva-se nos eventos middles:detected via SSE ou WebSocket para alertas em tempo real

Endpoints Relacionados

• Resumo de Middles — Estatísticas agregadas sem a lista completa
• Oportunidades +EV — Apostas com valor esperado positivo
• Oportunidades de Arbitragem — Oportunidades de lucro garantido
• Stream SSE — Eventos em tempo real middles:detected e middles:expired
• Melhores Odds — Compare odds entre todos os books