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/clvSe requiere nivel Enterprise. Los endpoints agregados /api/v1/historical/* están restringidos por la funcionalidad history. Los niveles inferiores reciben 403 tier_restricted. Si estás en Pro o Sharp y quieres datos de líneas de cierre, usa Cuotas de cierre — precios de cierre brutos por evento, disponibles en tu nivel.
La URL ha cambiado. Este endpoint se servía anteriormente en /api/v1/historical/clv. La ruta antigua sigue funcionando pero está obsoleta — sus respuestas incluyen Deprecation: true y una cabecera Link: </api/v1/historical/odds/clv>; rel="successor-version". No se ha anunciado ninguna fecha de retirada; la ruta antigua no será eliminada sin previo aviso. Utiliza /api/v1/historical/odds/clv en nuevas integraciones.
Cambiado 2026-09-19 — win_rate ahora cubre todas las apuestas liquidadas. Hasta esta versión, wins, losses y win_rate contaban solo las selecciones liquidadas que además tenían una línea de cierre capturada. Ahora cuentan todas las selecciones liquidadas, se haya capturado o no una línea de cierre. Dos consecuencias: como liquidar una apuesta no requiere una línea de cierre capturada, wins + losses supera habitualmente a total_graded, y win_rate se mueve — en el conjunto de la serie +EV reciente queda alrededor de dos puntos por debajo, aunque un grupo concreto puede moverse en cualquier dirección. total_graded, avg_clv_percent y avg_ev_percent no cambian, y no se ha añadido, eliminado ni renombrado ningún campo. Si has usado la win_rate antigua como referencia, rehaz tu línea base a partir de esta fecha.
Cómo se calcula el CLVEnlace permanente a esta sección
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) × 100donde 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 consultaEnlace permanente a esta sección
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
from | string | hace 7 días | Fecha de inicio (YYYY-MM-DD o ISO 8601). Limitada a la ventana de histórico de tu nivel. |
to | string | hoy | Fecha de fin (YYYY-MM-DD o ISO 8601). |
group_by | string | sportsbook | Dimensión de agregación. Una de: sportsbook, sport, league, market, day, devig_book. |
sport | string | todos | Filtrar por deporte(s), separados por comas (p. ej. basketball,baseball). |
league | string | todas | Filtrar por liga(s), separadas por comas (p. ej. nba,mlb). |
sportsbook | string | todas | Filtrar por casa(s) de apuestas, separadas por comas. |
devig_book | string | todas | Filtrar por la referencia sharp contra la que se valoró la selección (p. ej. pinnacle). |
Ventana de históricoEnlace permanente a esta sección
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.
El historial de CLV empieza el 2026-09-11 (08:17 UTC). Las selecciones anteriores no se sirven, así que una ventana from/to que termina antes de esa fecha devuelve un array groups vacío en lugar de un error.
Filtra por devig_book=pinnacle para obtener la señal significativa. La validez del CLV está dominada por la referencia sharp contra la que se valoró la selección. El CLV referenciado a Pinnacle es la serie predictiva; las selecciones valoradas contra referencias de respaldo (p. ej. bookmaker) presentan un CLV estructuralmente negativo y no deben interpretarse como ventaja. Agrupa por devig_book para ver la diferencia.
Ejemplos de solicitudesEnlace permanente a esta sección
cURL
# 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-09-14&to=2026-09-21" \
-H "X-API-Key: YOUR_API_KEY"RespuestaEnlace permanente a esta sección
Éxito (200)Enlace permanente a esta sección
{
"success": true,
"data": {
"date_range": {
"from": "2026-10-07T09:53:31.881",
"to": "2026-10-14T09:53:31.881"
},
"group_by": "sportsbook",
"groups": [
{
"group_key": "matchbook",
"total_graded": 7585,
"wins": 4846,
"losses": 4105,
"win_rate": 0.541392023237627,
"avg_clv_percent": -1.4250430370269482,
"avg_ev_percent": 1.3196234670527511,
"total_predictions": 10039
},
{
"group_key": "sx_bet",
"total_graded": 7310,
"wins": 3423,
"losses": 3290,
"win_rate": 0.5099061522419187,
"avg_clv_percent": -0.4994217699214386,
"avg_ev_percent": 1.0263501475197079,
"total_predictions": 7414
}
]
},
"meta": {
"filters": {
"devig_book": null,
"group_by": "sportsbook",
"league": null,
"sport": null,
"sportsbook": null
},
"groups_limit": 500,
"groups_total": 52,
"groups_truncated": false,
"source": "clickhouse",
"tier_window_days": "unlimited",
"updated_at": "2026-10-14T08:50:20Z"
}
}Este ejemplo responde a una solicitud sin parámetros (group_by=sportsbook sobre los últimos 7 días), capturada el 2026-10-14 y recortada a los dos primeros de sus 52 grupos. El bloque meta no se ha editado, así que groups_total sigue contando los 52.
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.
Una respuesta incluye como máximo meta.groups_limit (500) grupos, y el endpoint no tiene limit, offset ni cursor. Los grupos se ordenan por total_graded de mayor a menor, y los empates se resuelven por group_key. Esto también vale para group_by=day, así que ordena tú mismo por group_key si necesitas una serie temporal. Cuando hay más grupos válidos de los que permite el tope, la respuesta contiene los primeros 500 en ese orden, meta.groups_total indica cuántos grupos había y meta.groups_truncated es true. En la práctica solo group_by=league sobre una ventana de varias semanas alcanza el tope; acorta la ventana o filtra por sport para ver el resto.
Tres recuentos distintos — no mezcles denominadores. total_predictions cuenta todas las selecciones rastreadas (incluidas las que nunca se calificaron). total_graded cuenta las selecciones con una calificación de CLV (se capturó y comparó una línea de cierre). wins + losses cuenta todas las selecciones cuyo resultado del partido está liquidado, se haya capturado o no una línea de cierre — y win_rate se calcula sobre esa población. Ambos son independientes, no anidados: liquidar no requiere línea de cierre, y una selección calificada por CLV puede no haberse liquidado todavía. Ninguno de los dos es un subconjunto del otro, y wins + losses supera habitualmente a total_graded. Un grupo puede mostrar legítimamente total_graded: 7585 junto a wins + losses: 8951. win_rate es null cuando un grupo no tiene apuestas liquidadas.
Respuestas de errorEnlace permanente a esta sección
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 respuestaEnlace permanente a esta sección
Objeto dataEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
date_range | object | from/to reales utilizados tras la limitación por nivel |
group_by | string | La dimensión utilizada para la agregación |
groups | array | Array de filas de grupo |
Campos de la fila de grupoEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
group_key | string | El identificador del grupo (nombre de la casa de apuestas, deporte, liga, tipo de mercado, fecha YYYY-MM-DD o devig book) |
total_graded | integer | Predicciones lógicas con una calificación de CLV (línea de cierre capturada y comparada) |
wins | integer | Predicciones cuyo resultado del partido se liquidó como victoria. Se cuentan sobre todas las predicciones liquidadas, no solo las calificadas por CLV |
losses | integer | Predicciones cuyo resultado del partido se liquidó como derrota. Se cuentan sobre todas las predicciones liquidadas, no solo las calificadas por CLV |
win_rate | number | null | wins / (wins + losses). Calculado sobre todas las predicciones liquidadas — una población distinta de la de total_graded, con la que no comparte denominador; null cuando no existen apuestas liquidadas en el grupo |
avg_clv_percent | number | null | CLV% medio de las predicciones calificadas. Positivo = los precios detectados batieron al cierre en promedio. null cuando no es calculable |
avg_ev_percent | number | null | Valor esperado % medio en el momento de la detección para las predicciones del grupo. null cuando no es calculable |
total_predictions | integer | Todas las predicciones rastreadas en el grupo, incluidas las que (todavía) no han sido calificadas |
Objeto metaEnlace permanente a esta sección
| Campo | Tipo | Descripción |
|---|---|---|
filters | object | Eco de los filtros aplicados (sport, league, sportsbook, devig_book, group_by); null para los filtros no utilizados |
groups_limit | integer | Número máximo de grupos por respuesta (500). Es un tope, no un tamaño de página: no hay limit, offset ni cursor |
groups_total | integer | Grupos válidos para tus filtros y tu ventana (al menos una selección calificada por CLV o liquidada), contados antes de aplicar el tope |
groups_truncated | boolean | true cuando groups_total supera el número de grupos devueltos; la respuesta contiene entonces solo los primeros groups_limit grupos en orden de total_graded. Siempre presente |
source | string | "clickhouse" — el almacén de analítica histórica |
tier_window_days | integer | string | Retroceso máximo para tu nivel (p. ej. 90), o "unlimited" |
updated_at | string | Frescura de los datos, no la hora de la respuesta: el momento en que SharpAPI detectó por primera vez la selección más reciente contada en la respuesta (ISO 8601, UTC, segundos enteros). Una selección solo se cuenta cuando ya está calificada por CLV o liquidada, por lo que este valor va por detrás de la hora de la solicitud y solo avanza cuando se califica o liquida una selección detectada más tarde. Si ninguna selección coincide, usa la hora de la respuesta (con fracciones de segundo) |
Interpretación del CLVEnlace permanente a esta sección
| CLV% | Interpretación |
|---|---|
| > +2% | Los precios detectados batieron sistemáticamente al cierre por un margen amplio — alto valor capturado |
| +0,5% a +2% | Los precios batieron modestamente al cierre — típico de las casas soft frente a una referencia sharp |
| -0,5% a +0,5% | Próximo al mercado — precios eficientes o resultados mixtos |
| < -0,5% | Los precios se ajustaron hacia el cierre — steam tardío o acción del lado sharp |
El CLV no es ROI — léelo con las salvedades adecuadas.
- La eficiencia del mercado varía. En los mercados más sharp y líquidos (por ejemplo los spreads y totales de la NBA, y los props de jugador de las grandes ligas), batir al cierre no se convierte de forma fiable en beneficio realizado — allí, batir la línea de cierre suele reflejar ruido en un mercado eficiente más que ventaja. En mercados más soft, un CLV positivo sigue siendo el mejor indicador adelantado de rentabilidad a largo plazo.
- Usa
win_ratejunto conavg_clv_percent. El endpoint devuelve resultados realizados exactamente por esta razón: un grupo con CLV positivo pero con un historial liquidado por debajo del punto de equilibrio sobre una muestra grande te está diciendo que el CLV ahí no se está convirtiendo. Léelo como una dirección, no como una comparación equivalente:avg_clv_percentcubre las selecciones calificadas por CLV mientras quewin_ratecubre todas las selecciones liquidadas, así que ambos se calculan sobre poblaciones distintas. - Cuidado con el tamaño de la muestra. Los grupos con un
total_gradedpequeño o pocas apuestas liquidadas (wins + losses) son ruido — compara grupos solo con un volumen significativo. - La referencia sharp importa. Solo el CLV referenciado a una casa sharp (filtra
devig_book=pinnacle) tiene este significado; las filas referenciadas a respaldos no.
Endpoints relacionadosEnlace permanente a esta sección
- 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