Skip to Content
API-ReferenzClosing Line Value (CLV)

Closing Line Value (CLV)

Aggregierte Closing-Line-Value-Statistiken für die bewerteten +EV-Vorhersagen von SharpAPI. Für jede +EV-Gelegenheit, die die Engine markiert, erfasst das System später die Schlusslinie der Sharp-Referenz und bewertet den Pick dagegen — dieser Endpoint liefert diese Bewertungen, aggregiert entlang der von Ihnen gewählten Dimension (group_by), zusammen mit realisierten Gewinn-/Verlust-Ergebnissen, sofern das Spielergebnis bekannt ist.

GET /api/v1/historical/odds/clv

Enterprise-Tier erforderlich. Die /api/v1/historical/*-Aggregat-Endpoints sind durch das history-Feature gesperrt. Niedrigere Tiers erhalten 403 tier_restricted. Wenn Sie Pro oder Sharp nutzen und Schlusslinien-Daten benötigen, verwenden Sie Schlussquoten — rohe Schlusspreise pro Event, verfügbar in Ihrem Tier.

URL geändert. Dieser Endpoint wurde zuvor unter /api/v1/historical/clv bereitgestellt. Der alte Pfad funktioniert weiterhin, ist aber veraltet — Antworten darauf tragen Deprecation: true und einen Link: </api/v1/historical/odds/clv>; rel="successor-version"-Header. Es wurde kein Abschaltdatum angekündigt; der alte Pfad wird nicht ohne vorherige Ankündigung entfernt. Verwenden Sie in neuen Integrationen /api/v1/historical/odds/clv.

Geändert 2026-09-19 — win_rate umfasst jetzt jede abgerechnete Wette. Bis zu dieser Version zählten wins, losses und win_rate nur abgerechnete Picks, für die auch eine Schlusslinie erfasst worden war. Sie zählen jetzt jeden abgerechneten Pick, unabhängig davon, ob eine Schlusslinie erfasst wurde. Zwei Folgen: Da eine Abrechnung keine erfasste Schlusslinie voraussetzt, übersteigt wins + losses regelmäßig total_graded, und win_rate selbst verschiebt sich — über die jüngste +EV-Serie insgesamt liegt der Wert rund zwei Punkte niedriger, wobei sich eine einzelne Gruppe in beide Richtungen bewegen kann. total_graded, avg_clv_percent und avg_ev_percent bleiben unverändert, und kein Feld wurde hinzugefügt, entfernt oder umbenannt. Wenn Sie gegen die alte win_rate gebenchmarkt haben, setzen Sie Ihre Baseline ab diesem Datum neu.

Wie der CLV berechnet wirdPermalink zu diesem Abschnitt

Wenn ein Event vom Pre-Match- in den Live-Status übergeht, erfasst die Plattform den letzten Pre-Match-Preis jedes Buchmachers als Schlusslinie für dieses Event. Der Schlusspreis der Sharp-Referenz (devig_book — typischerweise Pinnacle) wird mit der Power-Methode zu einer No-Vig-Schlusswahrscheinlichkeit devigged, und jede bewertete Vorhersage wird wie folgt bewertet:

CLV% = (closing_no_vig_prob × entry_decimal_odds − 1) × 100

Dabei ist entry_decimal_odds der Preis zu dem Zeitpunkt, an dem SharpAPI die Gelegenheit markiert hat. Ein positiver CLV bedeutet, dass der markierte Preis die Schlusslinie geschlagen hat — Sie hätten zu besseren Quoten wetten können, als der finale faire Marktwert implizierte.

Die Daten stammen aus dem historischen ClickHouse-Speicher. Aggregate werden über logische Vorhersagen berechnet — wiederholte Preis-Snapshots desselben Picks (gleiches Event, gleicher Markt, gleiche Auswahl, gleicher Buchmacher, gleiche Linie) werden vor dem Zählen zu einer Zeile zusammengefasst, sodass ein Pick, der zu mehreren Preisen erneut beobachtet wurde, nicht mehrfach gezählt wird.

Query-ParameterPermalink zu diesem Abschnitt

ParameterTypStandardBeschreibung
fromstringvor 7 TagenStartdatum (YYYY-MM-DD oder ISO 8601). Wird auf das Verlaufsfenster Ihres Tiers begrenzt.
tostringheuteEnddatum (YYYY-MM-DD oder ISO 8601).
group_bystringsportsbookAggregationsdimension. Eine von: sportsbook, sport, league, market, day, devig_book.
sportstringalleFilter nach Sportart(en), kommagetrennt (z. B. basketball,baseball).
leaguestringalleFilter nach Liga(en), kommagetrennt (z. B. nba,mlb).
sportsbookstringalleFilter nach Sportsbook(s), kommagetrennt.
devig_bookstringalleFilter nach der Sharp-Referenz, gegen die der Pick bepreist wurde (z. B. pinnacle).

VerlaufsfensterPermalink zu diesem Abschnitt

Dieser Endpoint ist ausschließlich für Enterprise, und das Enterprise-Verlaufsfenster ist unbegrenzt (meta.tier_window_days = "unlimited"). from wird auf 7 Tage zurück gesetzt, wenn es weggelassen wird; es gibt keine erzwungene Obergrenze dafür, wie weit Sie zurückfragen können.

Die CLV-Historie beginnt am 2026-09-11 (08:17 UTC). Ältere Picks werden nicht ausgeliefert, daher liefert ein from/to-Fenster, das vor diesem Datum endet, ein leeres groups-Array statt eines Fehlers.

Filtern Sie nach devig_book=pinnacle für das aussagekräftige Signal. Die Validität des CLV wird von der Sharp-Referenz dominiert, gegen die der Pick bepreist wurde. Pinnacle-referenzierter CLV ist die prädiktive Serie; Picks, die gegen Fallback-Referenzen (z. B. bookmaker) bepreist wurden, weisen strukturell negativen CLV auf und sollten nicht als Edge gelesen werden. Gruppieren Sie nach devig_book, um die Aufteilung zu sehen.

BeispielanfragenPermalink zu diesem Abschnitt

# CLV nach Sportsbook für die letzten 7 Tage curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/clv?group_by=sportsbook" \ -H "X-API-Key: YOUR_API_KEY" # Nur Pinnacle-referenzierter CLV, gruppiert nach Sportart 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" # Tagesweiser CLV für DraftKings-Picks über einen Datumsbereich 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"

AntwortPermalink zu diesem Abschnitt

Erfolg (200)Permalink zu diesem Abschnitt

{ "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" } }

Dieses Beispiel ist die Antwort auf eine Anfrage ohne Parameter (group_by=sportsbook über die letzten 7 Tage), erfasst am 2026-10-14 und auf die ersten zwei ihrer 52 Gruppen gekürzt. Der meta-Block ist unverändert, daher zählt groups_total weiterhin alle 52.

Ein leeres groups-Array ist eine gültige Antwort, wenn für die angefragten Filter und den Datumsbereich keine bewerteten Vorhersagen existieren — kein Fehler.

Eine Antwort enthält höchstens meta.groups_limit (500) Gruppen, und der Endpoint kennt weder limit noch offset noch einen Cursor. Die Gruppen sind nach total_graded absteigend sortiert, bei Gleichstand nach group_key. Das gilt auch für group_by=day; sortieren Sie selbst nach group_key, wenn Sie eine Zeitreihe brauchen. Qualifizieren sich mehr Gruppen, als die Obergrenze zulässt, enthält die Antwort die ersten 500 in dieser Reihenfolge, meta.groups_total nennt die Zahl der qualifizierten Gruppen und meta.groups_truncated ist true. In der Praxis erreicht nur group_by=league über ein Fenster von mehreren Wochen die Obergrenze; verkleinern Sie das Fenster oder filtern Sie nach sport, um den Rest zu sehen.

Drei verschiedene Zählungen — vermischen Sie die Nenner nicht. total_predictions zählt jeden verfolgten Pick (einschließlich nie bewerteter). total_graded zählt Picks mit einer CLV-Bewertung (eine Schlusslinie wurde erfasst und verglichen). wins + losses zählt jeden Pick, dessen Spielergebnis abgerechnet ist — unabhängig davon, ob eine Schlusslinie erfasst wurde — und win_rate wird über diese Grundgesamtheit berechnet. Die beiden sind unabhängig und nicht ineinander verschachtelt: eine Abrechnung benötigt keine Schlusslinie, und ein CLV-bewerteter Pick ist möglicherweise noch nicht abgerechnet. Keine der beiden ist eine Teilmenge der anderen, und wins + losses übersteigt regelmäßig total_graded. Eine Gruppe kann legitim total_graded: 7585 neben wins + losses: 8951 aufweisen. win_rate ist null, wenn eine Gruppe keine abgerechneten Wetten hat.

FehlerantwortenPermalink zu diesem Abschnitt

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" } }

AntwortfelderPermalink zu diesem Abschnitt

data-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
date_rangeobjectTatsächlich verwendete from/to-Werte nach Tier-Begrenzung
group_bystringDie für die Aggregation verwendete Dimension
groupsarrayArray von Gruppenzeilen

Felder der GruppenzeilePermalink zu diesem Abschnitt

FeldTypBeschreibung
group_keystringDer Gruppenbezeichner (Sportsbook-Name, Sportart, Liga, Markttyp, YYYY-MM-DD-Datum oder Devig-Book)
total_gradedintegerLogische Vorhersagen mit einer CLV-Bewertung (Schlusslinie erfasst und verglichen)
winsintegerVorhersagen, deren Spielergebnis als Gewinn abgerechnet wurde. Gezählt über alle abgerechneten Vorhersagen, nicht nur über CLV-bewertete
lossesintegerVorhersagen, deren Spielergebnis als Verlust abgerechnet wurde. Gezählt über alle abgerechneten Vorhersagen, nicht nur über CLV-bewertete
win_ratenumber | nullwins / (wins + losses). Wird über alle abgerechneten Vorhersagen berechnet — eine andere Grundgesamtheit als total_graded, sodass beide keinen Nenner teilen; null, wenn keine abgerechneten Wetten in der Gruppe existieren
avg_clv_percentnumber | nullDurchschnittlicher CLV% über die bewerteten Vorhersagen. Positiv = markierte Preise haben die Schlusslinie im Durchschnitt geschlagen. null, wenn nicht berechenbar
avg_ev_percentnumber | nullDurchschnittlicher erwarteter Wert in % zum Erkennungszeitpunkt für die Vorhersagen der Gruppe. null, wenn nicht berechenbar
total_predictionsintegerAlle verfolgten Vorhersagen in der Gruppe, einschließlich (noch) nicht bewerteter

meta-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
filtersobjectEcho der angewendeten Filter (sport, league, sportsbook, devig_book, group_by); null für nicht verwendete Filter
groups_limitintegerHöchstzahl an Gruppen pro Antwort (500). Eine Obergrenze, keine Seitengröße: Es gibt weder limit noch offset noch einen Cursor
groups_totalintegerAnzahl der Gruppen, die sich für Ihre Filter und Ihr Fenster qualifiziert haben (mindestens ein CLV-bewerteter oder abgerechneter Pick), gezählt vor Anwendung der Obergrenze
groups_truncatedbooleantrue, wenn groups_total größer ist als die Zahl der zurückgegebenen Gruppen; die Antwort enthält dann nur die ersten groups_limit Gruppen in total_graded-Reihenfolge. Immer vorhanden
sourcestring"clickhouse" — der historische Analytics-Speicher
tier_window_daysinteger | stringMaximaler Rückblick für Ihr Tier (z. B. 90) oder "unlimited"
updated_atstringDatenaktualität, nicht der Antwortzeitpunkt: der Zeitpunkt, an dem SharpAPI den neuesten in der Antwort gezählten Pick zuerst markiert hat (ISO 8601, UTC, ganze Sekunden). Ein Pick wird erst gezählt, wenn er CLV-bewertet oder abgerechnet ist; daher liegt der Wert hinter dem Anfragezeitpunkt und bewegt sich nur, wenn ein später markierter Pick bewertet oder abgerechnet wird. Passt kein Pick, wird der Antwortzeitpunkt verwendet (mit Sekundenbruchteilen)

Interpretation des CLVPermalink zu diesem Abschnitt

CLV%Interpretation
> +2%Markierte Preise haben die Schlusslinie durchgängig deutlich geschlagen — hoher erfasster Wert
+0,5% bis +2%Preise haben die Schlusslinie leicht geschlagen — typisch für Soft Books gegenüber einer Sharp-Referenz
-0,5% bis +0,5%Marktnah — effiziente Preisbildung oder gemischte Ergebnisse
< -0,5%Preise haben sich zum Schluss hin verengt — spätes Steam oder Sharp-Side-Action

CLV ist nicht ROI — lesen Sie ihn mit den richtigen Vorbehalten.

  • Die Markteffizienz variiert. In den schärfsten, liquidesten Märkten (zum Beispiel NBA-Spreads und -Totals sowie Player Props der großen Ligen) führt das Schlagen der Schlusslinie nicht zuverlässig zu realisiertem Gewinn — Closing-Line-Beats spiegeln dort oft Rauschen in einem effizienten Markt wider statt Edge. In weicheren Märkten bleibt positiver CLV der beste Frühindikator für langfristige Profitabilität.
  • Nutzen Sie win_rate zusammen mit avg_clv_percent. Der Endpoint liefert realisierte Ergebnisse genau aus diesem Grund: Eine Gruppe mit positivem CLV, aber einer abgerechneten Bilanz unterhalb des Break-even über eine große Stichprobe sagt Ihnen, dass der CLV dort nicht konvertiert. Lesen Sie die Gegenüberstellung als Richtung, nicht als Vergleich gleicher Größen: avg_clv_percent deckt CLV-bewertete Picks ab, win_rate dagegen jeden abgerechneten Pick, die beiden werden also über unterschiedliche Grundgesamtheiten berechnet.
  • Achten Sie auf die Stichprobengröße. Gruppen mit kleinem total_graded oder wenigen abgerechneten Wetten (wins + losses) sind Rauschen — vergleichen Sie Gruppen nur bei aussagekräftigem Volumen.
  • Die Sharp-Referenz ist entscheidend. Nur Sharp-referenzierter CLV (Filter devig_book=pinnacle) trägt diese Bedeutung; Fallback-referenzierte Zeilen nicht.

Verwandte EndpointsPermalink zu diesem Abschnitt

Last updated on