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

> Mesurer la valeur à la clôture face au prix Pinnacle — le meilleur indicateur de rentabilité à long terme.

Le **CLV** (Closing Line Value) compare le **prix auquel vous avez parié** au **prix de clôture** (la dernière cote juste avant le coup d'envoi). Comme la ligne de clôture de Pinnacle est la plus *sharp* du marché, la battre régulièrement est **le meilleur prédicteur de profit à long terme** — bien plus fiable que le résultat d'un pari isolé.

Un CLV positif = vous avez pris une cote **meilleure** que le marché final. Sur des centaines de paris, un CLV moyen positif tend vers un ROI positif.

## Comment le calculer

`CLV% = (cote_pari / cote_clôture − 1) × 100`

Exemple : vous pariez à **2,10**, la clôture ressort à **1,90**. `2,10 / 1,90 − 1 = +10,5 %` → vous avez battu la clôture de 10,5 %.

<Info>
  Utilisez le **prix juste** (devig, `todds`) de clôture plutôt que la cote brute : la marge fausse la comparaison. L'endpoint `/api/clv` renvoie déjà un CLV net de marge.
</Info>

## Avec apinn

L'endpoint [`/api/clv`](/api-reference/introduction) fait le calcul pour vous : donnez l'event, la période, le marché, la sélection et votre `bet_price`.

<Steps>
  <Step title="Interroger le CLV d'un pari">
    ```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: VOTRE_CLE"
    # → { "closing_price": 3.11, "clv_pct": 12.54 }
    ```
  </Step>

  <Step title="Suivre le CLV moyen de votre portefeuille">
    Stockez le `clv_pct` de chaque pari et suivez la **moyenne** dans le temps : c'est votre boussole de rentabilité.
  </Step>
</Steps>

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

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

# vos paris passés : (event_id, période, marché, sélection, cote prise)
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}%  (clôture {r['closing_price']})")

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

## Bonnes pratiques

* **Jugez sur le CLV, pas sur le résultat** : un pari perdant avec CLV positif reste une bonne décision.
* **Volume** : le CLV n'a de sens qu'agrégé sur beaucoup de paris.
* **Timing** : plus vous pariez tôt (avant que la ligne ne se durcisse), plus le CLV potentiel est élevé — voir [dropping odds](/concepts/dropping-odds).
* **Référence** : comparez toujours à la clôture **Pinnacle**, la plus efficiente.