Closing Line Value (CLV)

Estatísticas agregadas de Closing Line Value para as previsões +EV avaliadas (graded) da SharpAPI. Para cada oportunidade +EV que o engine sinaliza, o sistema captura posteriormente a linha de fechamento da referência sharp e avalia o palpite contra ela — este endpoint serve essas avaliações, agregadas pela dimensão que você escolher (group_by), junto com os resultados realizados de vitória/derrota quando o resultado do jogo é conhecido.

GET /api/v1/historical/odds/clv

Como o CLV é calculadoPermalink for this section

Quando um evento passa de pré-partida para ao vivo, a plataforma captura o último preço pré-partida de cada book como a linha de fechamento daquele evento. O preço de fechamento da referência sharp (devig_book — tipicamente a Pinnacle) é devigado com o método Power para uma probabilidade de fechamento no-vig, e cada previsão avaliada recebe a pontuação:

CLV% = (closing_no_vig_prob × entry_decimal_odds − 1) × 100

onde entry_decimal_odds é o preço no momento em que a SharpAPI sinalizou a oportunidade. CLV positivo significa que o preço sinalizado venceu o fechamento — você poderia ter apostado em odds melhores do que o valor justo final implícito pelo mercado.

Os dados são servidos a partir do armazenamento histórico em ClickHouse. As agregações são calculadas sobre previsões lógicas — snapshots de preço repetidos do mesmo palpite (mesmo evento, mercado, seleção, book, linha) são colapsados em uma única linha antes da contagem, de modo que um palpite reobservado em vários preços não é contado múltiplas vezes.

Parâmetros de QueryPermalink for this section

Janela de históricoPermalink for this section

Este endpoint é exclusivo do tier Enterprise, e a janela de histórico do Enterprise é ilimitada (meta.tier_window_days = "unlimited"). from assume 7 dias atrás quando omitido; não há limite superior imposto para quão longe você pode consultar no passado.

Exemplos de RequisiçõesPermalink for this section

# CLV por sportsbook nos últimos 7 dias
curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/clv?group_by=sportsbook" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Apenas CLV referenciado na Pinnacle, agrupado por esporte
curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/clv?devig_book=pinnacle&group_by=sport" \
  -H "X-API-Key: YOUR_API_KEY"
 
# CLV dia a dia para palpites na DraftKings em um intervalo de datas
curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/clv?sportsbook=draftkings&group_by=day&from=2026-06-01&to=2026-06-08" \
  -H "X-API-Key: YOUR_API_KEY"

const params = new URLSearchParams({
  devig_book: 'pinnacle',
  group_by: 'sportsbook',
});
const response = await fetch(
  `https://api.sharpapi.io/api/v1/historical/odds/clv?${params}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
for (const group of data.groups) {
  // avg_clv_percent, avg_ev_percent e win_rate são null quando um grupo
  // não tem linhas avaliadas / liquidadas — proteja antes de formatar.
  const clv = group.avg_clv_percent !== null
    ? `${group.avg_clv_percent.toFixed(2)}%`
    : 'n/a';
  const wr = group.win_rate !== null
    ? `${(group.win_rate * 100).toFixed(1)}% over ${group.wins + group.losses} settled`
    : 'no settled bets';
  console.log(`${group.group_key}: avg CLV ${clv} (${group.total_graded} graded), win rate ${wr}`);
}

import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/historical/odds/clv',
    params={'devig_book': 'pinnacle', 'group_by': 'sportsbook'},
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
payload = response.json()
for group in payload['data']['groups']:
    # avg_clv_percent / avg_ev_percent / win_rate são None quando um grupo
    # não tem linhas avaliadas / liquidadas — proteja antes de formatar.
    clv = (
        f"{group['avg_clv_percent']:.2f}%"
        if group['avg_clv_percent'] is not None else 'n/a'
    )
    settled = group['wins'] + group['losses']
    wr = (
        f"{group['win_rate'] * 100:.1f}% over {settled} settled"
        if group['win_rate'] is not None else 'no settled bets'
    )
    print(f"{group['group_key']}: avg CLV {clv} "
          f"({group['total_graded']} graded), win rate {wr}")

RespostaPermalink for this section

Sucesso (200)Permalink for this section

{
  "success": true,
  "data": {
    "date_range": {
      "from": "2026-06-03T14:12:30.437",
      "to": "2026-06-10T14:12:30.437"
    },
    "group_by": "sportsbook",
    "groups": [
      {
        "group_key": "novig",
        "total_graded": 1294,
        "wins": 767,
        "losses": 635,
        "win_rate": 0.5470756062767475,
        "avg_clv_percent": 0.673342797764432,
        "avg_ev_percent": 1.613983921390446,
        "total_predictions": 1555
      },
      {
        "group_key": "prophetx",
        "total_graded": 964,
        "wins": 500,
        "losses": 608,
        "win_rate": 0.45126353790613716,
        "avg_clv_percent": 0.07641414602522267,
        "avg_ev_percent": 1.4343012769214647,
        "total_predictions": 1331
      }
    ]
  },
  "meta": {
    "filters": {
      "devig_book": null,
      "group_by": "sportsbook",
      "league": null,
      "sport": null,
      "sportsbook": null
    },
    "source": "clickhouse",
    "tier_window_days": "unlimited",
    "updated_at": "2026-06-10T14:12:58.75061216Z"
  }
}

Um array groups vazio é uma resposta válida quando não existem previsões avaliadas para os filtros e o intervalo de datas solicitados — não é um erro.

Respostas de ErroPermalink for this section

403 Tier Restricted

{
  "error": {
    "code": "tier_restricted",
    "message": "This endpoint requires Enterprise tier or higher",
    "docs": "https://sharpapi.io/pricing",
    "tier": "pro",
    "required_tier": "enterprise"
  }
}

400 Validation Error

{
  "error": {
    "code": "validation_error",
    "message": "Invalid group_by. Must be one of: day, devig_book, league, market, sport, sportsbook"
  }
}

Campos da RespostaPermalink for this section

Objeto dataPermalink for this section

Campos da linha de grupoPermalink for this section

Objeto metaPermalink for this section

Interpretando o CLVPermalink for this section

Endpoints RelacionadosPermalink for this section

• Closing Odds — Preços de fechamento brutos por evento (tier Pro ou superior)
• Closing Odds por Data — Preços de fechamento históricos por evento para uma data específica
• Oportunidades +EV — Apostas de valor esperado positivo em tempo real
• Snapshot de Odds — Odds atuais pré-partida e ao vivo