Valor de la Línea de Cierre (CLV)

Estadísticas agregadas de Valor de la Línea de Cierre para las predicciones +EV calificadas de SharpAPI. Para cada oportunidad +EV que el motor detecta, el sistema captura posteriormente la línea de cierre de la referencia sharp y califica la selección contra ella — este endpoint sirve esas calificaciones, agregadas según la dimensión que elijas (group_by), junto con los resultados realizados de victoria/derrota cuando se conoce el resultado del partido.

GET /api/v1/historical/odds/clv

Cómo se calcula el CLVPermalink for this section

Cuando un evento pasa de pre-match a en directo, la plataforma captura el último precio pre-match de cada casa como la línea de cierre de ese evento. El precio de cierre de la referencia sharp (devig_book — normalmente Pinnacle) se devigea con el método Power para obtener una probabilidad de cierre sin margen (no-vig), y cada predicción calificada se puntúa como:

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

donde entry_decimal_odds es el precio en el momento en que SharpAPI detectó la oportunidad. Un CLV positivo significa que el precio detectado batió al cierre — podrías haber apostado a mejores cuotas que las que implicaba el valor justo final del mercado.

Los datos se sirven desde el almacén histórico ClickHouse. Los agregados se calculan sobre predicciones lógicas — los snapshots de precio repetidos de la misma selección (mismo evento, mercado, selección, casa, línea) se colapsan en una sola fila antes de contar, de modo que una selección re-observada a varios precios no se cuenta varias veces.

Parámetros de consultaPermalink for this section

Ventana de históricoPermalink for this section

Este endpoint es exclusivo de Enterprise, y la ventana de histórico de Enterprise es ilimitada (meta.tier_window_days = "unlimited"). from toma por defecto hace 7 días cuando se omite; no hay un límite superior impuesto sobre cuánto puedes retroceder en la consulta.

Ejemplos de solicitudesPermalink for this section

# CLV por casa de apuestas durante los últimos 7 días
curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/clv?group_by=sportsbook" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Solo CLV referenciado a Pinnacle, agrupado por deporte
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 día a día para las selecciones de DraftKings en un rango de fechas
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 y win_rate son null cuando un grupo
  // no tiene filas calificadas / liquidadas — comprueba antes de formatear.
  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 son None cuando un grupo
    # no tiene filas calificadas / liquidadas — comprueba antes de formatear.
    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}")

RespuestaPermalink for this section

Éxito (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"
  }
}

Un array groups vacío es una respuesta válida cuando no existen predicciones calificadas para los filtros y el rango de fechas solicitados — no es un error.

Respuestas de errorPermalink 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 de la respuestaPermalink for this section

Objeto dataPermalink for this section

Campos de la fila de grupoPermalink for this section

Objeto metaPermalink for this section

Interpretación del CLVPermalink for this section

Endpoints relacionadosPermalink for this section

• Cuotas de cierre — Precios de cierre brutos por evento (nivel Pro y superiores)
• Cuotas de cierre por fecha — Precios de cierre históricos por evento para una fecha determinada
• Oportunidades +EV — Apuestas de valor esperado positivo en tiempo real
• Snapshot de cuotas — Cuotas pre-match y en directo actuales