Closing Line Value (CLV)

Analise o quão bem as odds de fechamento de um sportsbook se comparam com a probabilidade devigada (no-vig) da Pinnacle. CLV positivo significa que o book fechou mais frouxo que a Pinnacle — um proxy histórico para vantagem (edge).

GET /api/v1/historical/clv

Como as Linhas de Fechamento São Capturadas

Quando um jogo passa de pré-partida para ao vivo, o servidor captura as últimas odds de pré-partida de cada book como a linha de fechamento daquele evento. O preço de fechamento é devigado usando o método Power (o mesmo do cálculo de EV) para produzir uma probabilidade no-vig por seleção.

O CLV é então calculado como:

CLV% = (pin_no_vig_prob - book_no_vig_prob) / book_no_vig_prob × 100

Onde pin_no_vig_prob é a probabilidade devigada da Pinnacle (a referência sharp) e book_no_vig_prob é a probabilidade devigada do book recreativo (soft book). Um CLV% positivo significa que o book recreativo fechou em um preço mais favorável do que a linha justa da Pinnacle.

Autenticação

Requer API key. Tier Sharp ou superior obrigatório (feature closing_lines).

Parâmetros de Query

Janela de Datas

O tier Sharp permite até 30 dias de histórico (a janela atual de retenção para dados de linha de fechamento). Solicitar datas fora dessa janela é silenciosamente ajustado para a data mais antiga disponível.

Exemplos de Requisições

# CLV por sportsbook nos últimos 7 dias
curl -X GET "https://api.sharpapi.io/api/v1/historical/clv?from=2026-04-10&to=2026-04-17&group_by=sportsbook" \
  -H "X-API-Key: YOUR_API_KEY"
 
# CLV agrupado por esporte, apenas NBA
curl -X GET "https://api.sharpapi.io/api/v1/historical/clv?league=nba&group_by=sport" \
  -H "X-API-Key: YOUR_API_KEY"
 
# CLV agrupado por dia para a DraftKings
curl -X GET "https://api.sharpapi.io/api/v1/historical/clv?sportsbook=draftkings&group_by=day" \
  -H "X-API-Key: YOUR_API_KEY"

const params = new URLSearchParams({
  from: '2026-04-10',
  to: '2026-04-17',
  group_by: 'sportsbook',
});
const response = await fetch(
  `https://api.sharpapi.io/api/v1/historical/clv?${params}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
for (const group of data.groups) {
  console.log(`${group.group_key}: avg CLV ${group.avg_clv_percent.toFixed(2)}% (${group.samples} samples)`);
}

import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/historical/clv',
    params={
        'from': '2026-04-10',
        'to': '2026-04-17',
        'group_by': 'sportsbook',
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
data = response.json()
for group in data['data']['groups']:
    print(
        f"{group['group_key']}: "
        f"avg CLV {group['avg_clv_percent']:.2f}% "
        f"({group['samples']} samples)"
    )

Resposta

Sucesso (200)

{
  "success": true,
  "data": {
    "group_by": "sportsbook",
    "groups": [
      {
        "group_key": "draftkings",
        "samples": 312,
        "avg_clv_percent": 1.42,
        "avg_abs_clv_percent": 2.18,
        "distinct_books": 1,
        "distinct_sports": 4
      },
      {
        "group_key": "fanduel",
        "samples": 289,
        "avg_clv_percent": 0.87,
        "avg_abs_clv_percent": 1.95,
        "distinct_books": 1,
        "distinct_sports": 4
      },
      {
        "group_key": "betmgm",
        "samples": 201,
        "avg_clv_percent": -0.21,
        "avg_abs_clv_percent": 1.74,
        "distinct_books": 1,
        "distinct_sports": 3
      }
    ],
    "date_range": {
      "from": "2026-04-10T00:00:00.000",
      "to": "2026-04-17T00:00:00.000"
    },
    "total_events": 58,
    "comparable_events": 51,
    "sharp_reference": "pinnacle"
  },
  "meta": {
    "source": "valkey:closing_line",
    "tier_window_days": 30,
    "phase": "1",
    "filters": {
      "sport": null,
      "league": null,
      "sportsbook": null,
      "group_by": "sportsbook"
    },
    "updated_at": "2026-04-17T20:00:00.000000000Z"
  }
}

Resultado vazio (sem dados de linha de fechamento ainda):

{
  "success": true,
  "data": {
    "group_by": "sportsbook",
    "groups": [],
    "date_range": { "from": "...", "to": "..." },
    "total_events": 0,
    "comparable_events": 0,
    "sharp_reference": "pinnacle"
  },
  "meta": { "source": "valkey:closing_line", "phase": "1", ... }
}

Um array groups vazio é uma resposta válida quando nenhum dado de linha de fechamento foi capturado para o intervalo de datas solicitado — não é um erro.

Respostas de Erro

403 Tier Restricted

{
  "error": {
    "code": "tier_restricted",
    "message": "The 'closing_lines' feature requires Sharp or higher.",
    "required_tier": "sharp",
    "docs": "https://docs.sharpapi.io/en/pricing"
  }
}

400 Validation Error

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

Campos da Resposta

Objeto data

Campos da linha de grupo

Objeto meta

Interpretando o CLV

Um CLV médio positivo nas suas apostas é o indicador mais forte de que você está apostando em preços ineficientes. Em uma amostra grande, CLV positivo prevê fortemente ROI positivo.

Endpoints Relacionados

• Closing Odds por Data — Preços de fechamento brutos 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