> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CLV — Closing Line Value

> Mide el valor frente al precio de cierre de Pinnacle — el mejor indicador de rentabilidad a largo plazo.

El **CLV** (Closing Line Value) compara el **precio al que apostaste** con el **precio de cierre** (la última cuota justa antes del inicio). Como la línea de cierre de Pinnacle es la más *sharp* del mercado, batirla de forma constante es **el mejor predictor de beneficio a largo plazo** — mucho más fiable que el resultado de una apuesta aislada.

CLV positivo = tomaste una cuota **mejor** que el mercado final. Sobre cientos de apuestas, un CLV medio positivo tiende a un ROI positivo.

## Cómo calcularlo

`CLV% = (cuota_apuesta / cuota_cierre − 1) × 100`

Ejemplo: apuestas a **2,10**, el cierre queda en **1,90**. `2,10 / 1,90 − 1 = +10,5 %` → batiste el cierre un 10,5 %.

<Info>
  Usa el precio de cierre **justo** (devig, `todds`) en vez de la cuota bruta: el margen distorsiona la comparación. El endpoint `/api/clv` ya devuelve un CLV sin margen.
</Info>

## Con apinn

El endpoint [`/api/clv`](/es/api-reference/introduction) hace el cálculo por ti: pasa el evento, el periodo, el mercado, la selección y tu `bet_price`.

<Steps>
  <Step title="Consultar el CLV de una apuesta">
    ```bash theme={null}
    curl "https://api.apinn.io/api/clv?event_id=1632370816&period=0&market=moneyline&selection=draw&bet_price=3.5" \
      -H "X-API-Key: TU_CLAVE"
    # → { "closing_price": 3.11, "clv_pct": 12.54 }
    ```
  </Step>

  <Step title="Seguir el CLV medio de tu cartera">
    Guarda el `clv_pct` de cada apuesta y sigue la **media** en el tiempo — es tu brújula de rentabilidad.
  </Step>
</Steps>

```python Python theme={null}
import requests

BASE, H = "https://api.apinn.io", {"X-API-Key": "TU_CLAVE"}

# tus apuestas pasadas: (event_id, periodo, mercado, selección, cuota tomada)
bets = [
    (1632370816, 0, "moneyline", "draw", 3.5),
    (1632370817, 0, "moneyline", "home", 1.95),
]

clvs = []
for event_id, period, market, sel, price in bets:
    r = requests.get(f"{BASE}/api/clv", headers=H, params={
        "event_id": event_id, "period": period, "market": market,
        "selection": sel, "bet_price": price}).json()
    clvs.append(r["clv_pct"])
    print(f"{event_id} {sel}: CLV {r['clv_pct']:+.2f}%  (cierre {r['closing_price']})")

if clvs:
    print(f"\nCLV medio: {sum(clvs)/len(clvs):+.2f}%")
```

## Buenas prácticas

* **Juzga por el CLV, no por el resultado**: una apuesta perdedora con CLV positivo sigue siendo una buena decisión.
* **Volumen**: el CLV solo tiene sentido agregado sobre muchas apuestas.
* **Timing**: cuanto antes apuestas (antes de que la línea se endurezca), mayor es el CLV potencial — ver [dropping odds](/es/concepts/dropping-odds).
* **Referencia**: compara siempre con el cierre de **Pinnacle**, la línea más eficiente.