> ## 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

> Misura il valore rispetto al prezzo di chiusura Pinnacle — il miglior indicatore di redditività a lungo termine.

Il **CLV** (Closing Line Value) confronta il **prezzo a cui hai puntato** con il **prezzo di chiusura** (l'ultima quota equa poco prima del via). Poiché la linea di chiusura di Pinnacle è la più *sharp* del mercato, batterla con costanza è **il miglior predittore di profitto a lungo termine** — molto più affidabile del risultato di una singola scommessa.

CLV positivo = hai preso una quota **migliore** del mercato finale. Su centinaia di scommesse, un CLV medio positivo tende a un ROI positivo.

## Come calcolarlo

`CLV% = (quota_scommessa / quota_chiusura − 1) × 100`

Esempio: punti a **2,10**, la chiusura si assesta a **1,90**. `2,10 / 1,90 − 1 = +10,5 %` → hai battuto la chiusura del 10,5 %.

<Info>
  Usa il prezzo di chiusura **equo** (devig, `todds`) invece della quota grezza: il margine falsa il confronto. L'endpoint `/api/clv` restituisce già un CLV al netto del margine.
</Info>

## Con apinn

L'endpoint [`/api/clv`](/it/api-reference/introduction) fa il calcolo per te: passa l'evento, il periodo, il mercato, la selezione e il tuo `bet_price`.

<Steps>
  <Step title="Interrogare il CLV di una scommessa">
    ```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: LA_TUA_CHIAVE"
    # → { "closing_price": 3.11, "clv_pct": 12.54 }
    ```
  </Step>

  <Step title="Monitorare il CLV medio del tuo portafoglio">
    Salva il `clv_pct` di ogni scommessa e monitora la **media** nel tempo — è la tua bussola di redditività.
  </Step>
</Steps>

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

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

# le tue scommesse passate: (event_id, periodo, mercato, selezione, quota presa)
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}%  (chiusura {r['closing_price']})")

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

## Buone pratiche

* **Giudica sul CLV, non sul risultato**: una scommessa persa con CLV positivo resta una buona decisione.
* **Volume**: il CLV ha senso solo aggregato su molte scommesse.
* **Timing**: prima punti (prima che la linea si irrigidisca), più alto è il CLV potenziale — vedi [dropping odds](/it/concepts/dropping-odds).
* **Riferimento**: confronta sempre con la chiusura **Pinnacle**, la linea più efficiente.