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

> Mede o valor face ao preço de fecho da Pinnacle — o melhor indicador de rentabilidade a longo prazo.

O **CLV** (Closing Line Value) compara o **preço a que apostaste** com o **preço de fecho** (a última odd justa mesmo antes do início). Como a linha de fecho da Pinnacle é a mais *sharp* do mercado, batê-la de forma consistente é **o melhor preditor de lucro a longo prazo** — muito mais fiável do que o resultado de uma aposta isolada.

CLV positivo = apanhaste uma odd **melhor** do que o mercado final. Ao longo de centenas de apostas, um CLV médio positivo tende para um ROI positivo.

## Como calcular

`CLV% = (odd_aposta / odd_fecho − 1) × 100`

Exemplo: apostas a **2,10**, o fecho fica em **1,90**. `2,10 / 1,90 − 1 = +10,5 %` → bateste o fecho em 10,5 %.

<Info>
  Usa o preço de fecho **justo** (devig, `todds`) em vez da odd bruta: a margem distorce a comparação. O endpoint `/api/clv` já devolve um CLV sem margem.
</Info>

## Com a apinn

O endpoint [`/api/clv`](/pt/api-reference/introduction) faz o cálculo por ti: passa o evento, o período, o mercado, a seleção e o teu `bet_price`.

<Steps>
  <Step title="Consultar o CLV de uma aposta">
    ```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: A_TUA_CHAVE"
    # → { "closing_price": 3.11, "clv_pct": 12.54 }
    ```
  </Step>

  <Step title="Acompanhar o CLV médio da tua carteira">
    Guarda o `clv_pct` de cada aposta e acompanha a **média** ao longo do tempo — é a tua bússola de rentabilidade.
  </Step>
</Steps>

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

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

# as tuas apostas passadas: (event_id, período, mercado, seleção, odd apanhada)
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}%  (fecho {r['closing_price']})")

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

## Boas práticas

* **Avalia pelo CLV, não pelo resultado**: uma aposta perdida com CLV positivo continua a ser uma boa decisão.
* **Volume**: o CLV só faz sentido agregado sobre muitas apostas.
* **Timing**: quanto mais cedo apostas (antes de a linha endurecer), maior o CLV potencial — ver [dropping odds](/pt/concepts/dropping-odds).
* **Referência**: compara sempre com o fecho da **Pinnacle**, a linha mais eficiente.