Skip to Content
API-ReferenzSchlussquoten nach Datum

Historische Closing Odds

Rufen Sie die für alle Events an einem bestimmten Datum erfassten Closing Odds ab — den letzten Pre-Match-Preis jedes angegebenen Sportsbooks (eins bis fünf pro Anfrage), bevor ein Spiel live ging, mit devigten No-Vig-Wahrscheinlichkeiten.

GET /api/v1/historical/odds/closing

Enterprise-Tier erforderlich. Dieser Endpoint ist durch das history Feature gegated, das ausschließlich im Enterprise-Tier verfügbar ist. Niedrigere Tiers erhalten einen 403 tier_restricted Fehler.

Closing Lines werden in Echtzeit bei is_live false→true Übergängen erfasst und in ClickHouse persistiert. Es gibt keine rollierende Fensterbegrenzung: Jede seit dem Start des Archivs am 23. April 2026 gespeicherte Closing Line ist verfügbar (meta.tier_window_days ist "unlimited"). Frühere Daten liefern keine Events, da davor nichts erfasst wurde.

AuthentifizierungPermalink zu diesem Abschnitt

Erfordert API key. Enterprise-Tier erforderlich (history Feature).

Query-ParameterPermalink zu diesem Abschnitt

ParameterTypErforderlichBeschreibung
datestringJaDatum im Format YYYY-MM-DD (UTC).
sportstringJaSport-Identifikator, z. B. baseball, basketball, football.
leaguestringJaLiga-Identifikator, z. B. mlb, nba, nfl.
sportsbookstringJaEine bis fünf Sportsbook-IDs, z. B. pinnacle oder pinnacle,draftkings. Übergeben Sie eine kommagetrennte Liste, wiederholen Sie den Parameter (sportsbook=pinnacle&sportsbook=draftkings) oder beides. Duplikate zählen einmal. Mehr als fünf Sportsbooks ergeben 400.
event_idstringNeinLiefert nur dieses Event aus den Events des Datums. Ohne den Parameter kommt jedes Event des Datums zurück.
include_degradedbooleanNeinStandard false. Zeilen, deren „Closing“-Preis tatsächlich in-play gedriftet ist (lange nach dem Anpfiff bepreist), werden standardmäßig ausgeschlossen. Übergeben Sie true, um sie einzuschließen — jede solche Zeile ist mit odds_after_kickoff: true markiert, damit Sie sie aus der CLV-Berechnung ausschließen können.

date, sport, league und sportsbook sind erforderlich. Die Antwort wird auf Events gefiltert, die exakt dem Sport und der Liga an diesem UTC-Datum entsprechen, und jedes Event enthält nur die angegebenen Sportsbooks. Für mehr als fünf Sportsbooks stellen Sie eine Anfrage pro Gruppe von fünf.

BeispielanfragenPermalink zu diesem Abschnitt

curl -X GET "https://api.sharpapi.io/api/v1/historical/odds/closing?date=2026-06-30&sport=baseball&league=mlb&sportsbook=pinnacle,draftkings" \ -H "X-API-Key: YOUR_API_KEY"

AntwortPermalink zu diesem Abschnitt

Erfolg (200)Permalink zu diesem Abschnitt

Dies ist eine verpackte Antwort: { success, data, meta }.

Live-Antwort auf die obige Anfrage (gekürzt auf ein Event, Moneyline + ein Player Prop; eine echte Antwort enthält jeden erfassten Markt für jedes Event des Datums, für jedes angegebene Sportsbook):

{ "success": true, "data": { "date": "2026-06-30", "sport": "baseball", "league": "mlb", "events": [ { "event_id": "mlb_phillies_pirates_2026-06-30_b3", "sport": "baseball", "league": "mlb", "home_team": "Philadelphia Phillies", "away_team": "Pittsburgh Pirates", "event_start_time": "2026-06-30T22:40:00Z", "captured_at": "2026-06-30T22:42:56.227Z", "books": { "pinnacle": { "captured_at": "2026-07-01T02:18:19.094Z", "seconds_before_kickoff": -13099, "capture_trigger": "evict", "is_final": true, "odds": [ { "sportsbook": "pinnacle", "market_type": "moneyline", "market_id": "1632103992_moneyline_0", "selection": "Pittsburgh Pirates", "selection_type": "away", "selection_id": "away", "canonical_key": "mlb_phillies_pirates_2026-06-30_b3:moneyline:away", "odds_american": 182, "odds_decimal": 2.82, "implied_probability": 0.35460992907801414, "no_vig_probability": 0.34684612016316746, "fair_close_decimal": 2.88312292358804, "closing_probability": 0.3417584456103625, "source_updated_at": "2026-06-30T21:22:43.926672195Z", "max_bet": 15000, "team_side": "away" } ] }, "draftkings": { "captured_at": "2026-06-30T22:42:58.116Z", "seconds_before_kickoff": -13099, "capture_trigger": "backfill", "is_final": true, "odds": [ { "sportsbook": "draftkings", "market_type": "moneyline", "market_id": "1_85320694", "selection": "PIT Pirates", "selection_type": "away", "selection_id": "0ML85320694_3", "canonical_key": "mlb_phillies_pirates_2026-06-30_b3:moneyline:away", "odds_american": 191, "odds_decimal": 2.91, "implied_probability": 0.3436426116838488, "no_vig_probability": 0.32880208077734696, "fair_close_decimal": 3.04134328358209, "closing_probability": 0.3170282527982699, "source_updated_at": "2026-06-30T20:43:21.398Z", "team_side": "away" }, { "sportsbook": "draftkings", "market_type": "player_earned_runs", "market_id": "347277229", "selection": "Over", "selection_type": "over", "selection_id": "0QA347277229#2197684044_13L84240Q1-339433858Q20", "canonical_key": "mlb_phillies_pirates_2026-06-30_b3:player_earned_runs:chandler_bub:over:2.5", "line": 2.5, "odds_american": -136, "odds_decimal": 1.7352941176470589, "implied_probability": 0.576271186440678, "no_vig_probability": 0.5379072681704261, "fair_close_decimal": 1.8590564938846825, "closing_probability": 0.5420932938608679, "source_updated_at": "2026-06-30T22:39:57.090381809Z", "player_name": "Bubba Chandler", "stat_category": "earned_runs" } ] } } } ], "total_events": 15, "total_lines": 6096 }, "meta": { "source": "clickhouse", "tier_window_days": "unlimited", "filters": { "sport": "baseball", "league": "mlb", "date": "2026-06-30", "sportsbook": ["pinnacle", "draftkings"], "event_id": null }, "updated_at": "2026-11-07T12:13:58.317932502Z" } }

data.events ist null (nicht []), wenn für dieses Datum keine Events den Filtern entsprechen.

FehlerantwortenPermalink zu diesem Abschnitt

400 Validierungsfehler

{ "error": { "code": "validation_error", "message": "sportsbook parameter is required" } }

Weitere 400-Meldungen, alle mit dem Code validation_error: sport parameter is required, league parameter is required, date parameter is required in YYYY-MM-DD format, sportsbook accepts at most 5 books per request, got N, event_id exceeds maximum length und Invalid event_id format.

403 Tier-Beschränkung (falscher Tier)

{ "error": { "code": "tier_restricted", "message": "This endpoint requires Enterprise tier or higher", "docs": "https://sharpapi.io/pricing", "tier": "pro", "required_tier": "enterprise" } }

AntwortfelderPermalink zu diesem Abschnitt

data ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
datestringDas angefragte Datum (YYYY-MM-DD)
sportstringAngewandter Sport-Filter
leaguestringAngewandter Liga-Filter
eventsarray | nullClosing-Line-Events, die dem Datum, Sport und der Liga entsprechen, nur mit den angefragten Sportsbooks. null, wenn keine passen.
total_eventsintegerAnzahl der Events in der Antwort
total_linesintegerGesamtzahl der einzelnen Closing Lines über alle Events und Sportsbooks

Event-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
event_idstringKanonischer Event-Identifikator
sportstringSport
leaguestringLiga
home_teamstringName des Heimteams
away_teamstringName des Auswärtsteams
event_start_timestringGeplante Startzeit im ISO-8601-Format
captured_atstringISO-8601-Zeitstempel der ersten Closing-Line-Erfassung für dieses Event
booksobjectMap von Sportsbook-ID → Closing-Payload pro Sportsbook (siehe unten)

Payload pro Sportsbook (books[<sportsbook>])Permalink zu diesem Abschnitt

FeldTypBeschreibung
oddsarrayClosing-Line-Einträge für dieses Sportsbook (siehe unten)
captured_atstringISO-8601-Zeitpunkt, zu dem die Closing Line dieses Sportsbooks erfasst wurde
seconds_before_kickoffintegerSekunden vor dem Anpfiff bei der Erfassung. Negativ, wenn die Erfassung nach dem geplanten Start erfolgte — leicht negativ bei transition/kickoff-Erfassungen, möglicherweise Stunden negativ bei evict/backfill-Erfassungen (die Odds selbst sind trotzdem die letzten gesehenen Pre-Match-Preise).
capture_triggerstringAuslöser der Erfassung: transition | kickoff | disappearance | evict | backfill (Konfidenzreihenfolge: transition > kickoff > andere)
is_finalbooleanOb dies die finale/gesperrte Closing-Erfassung für das Sportsbook ist

Closing-Line-Eintrag (books[<sportsbook>].odds[])Permalink zu diesem Abschnitt

Optionale Felder werden im JSON weggelassen (nicht als null serialisiert), wenn sie nicht zutreffen — prüfen Sie auf Vorhandensein ('line' in entry / .get()) statt auf null.

FeldTypBeschreibung
sportsbookstringSportsbook-ID
market_typestringMarkttyp: moneyline, point_spread, total_runs, player_earned_runs, etc.
market_idstringNativer Markt-Identifikator des Sportsbooks
selectionstringAuswahlbezeichnung (Teamname, Over/Under, Spieler)
selection_typestringhome, away, over, under, etc.
selection_idstringNativer Auswahl-Identifikator des Sportsbooks
canonical_keystringStabiler, sportsbookübergreifender Schlüssel zum Verknüpfen: <event_id>:<market_type>[:<player>]:<selection_type>[:<line>]. Fehlt bei einem kleinen Anteil der Zeilen, für die kein kanonischer Schlüssel abgeleitet werden konnte.
linenumberSpread- oder Total-Wert (-3.5, 2.5). Weggelassen bei Moneylines und anderen Märkten ohne Linie.
odds_americanintegerAmerican Odds beim Schluss
odds_decimalnumberDecimal Odds beim Schluss
implied_probabilitynumberRohe implizite Wahrscheinlichkeit (mit Vig)
no_vig_probabilitynumberProportional devigte faire Wahrscheinlichkeit (0.0–1.0) innerhalb des komplementären Marktpaars dieses Sportsbooks. Weggelassen, wenn die erfassten Auswahlen keine vollständige komplementäre Gruppe bilden (z. B. Mehrwegmärkte, fehlendes Gegenstück).
fair_close_decimalnumberFairer (No-Vig) Decimal-Preis beim Schluss. Genau dann vorhanden, wenn no_vig_probability vorhanden ist.
closing_probabilitynumberPower-devigte faire Closing-Wahrscheinlichkeit (der für CLV verwendete Wert). Weggelassen, wenn kein komplementäres Paar verfügbar war.
source_updated_atstringISO-8601-Zeitstempel, zu dem der Quell-Odds-Datensatz upstream zuletzt als aktuell bestätigt wurde (zuletzt aktiv gesehen, nicht letzte Preisänderung)
player_namestringSpielername — nur Player-Prop-Märkte
stat_categorystringStatistikkategorie des Player Props (z. B. earned_runs, total_bases) — nur Player-Prop-Märkte
team_sidestringhome | away | draw — die Team-Achse für teamgebundene Zeilen (Moneylines, Team-Totals). Fehlt, wenn nicht teamgebunden.
market_segmentstringSpielabschnitt, den der Markt abdeckt (1st_half, 1st_5_innings, …). Fehlt bei Märkten für das ganze Spiel.
max_betnumberMaximaler Einsatz des Sportsbooks auf diese Auswahl beim Schluss — nur bei Sportsbooks, die Limits veröffentlichen (z. B. Pinnacle)
odds_after_kickoffbooleantrue, wenn sich der Preis der Zeile zuletzt lange nach dem Anpfiff bewegt hat (In-Play-Drift, kein echter Schlusskurs). Solche Zeilen erscheinen nur mit include_degraded=true; schließen Sie sie aus der CLV-Berechnung aus.

meta ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
sourcestringBacking Store — "clickhouse"
tier_window_daysstringLookback-Fenster — "unlimited" im Enterprise-Tier: keine rollierende Grenze, zurück bis zum Archivstart am 2026-04-23
filtersobjectEcho der angewandten Filter: sport, league, date, sportsbook (ein Array der Sportsbooks in Anfragereihenfolge) und event_id (null, wenn nicht gesendet)
updated_atstringISO-8601-Zeitstempel der Antwort

AnwendungsfällePermalink zu diesem Abschnitt

CLV-Analyse: Vergleichen Sie no_vig_probability / closing_probability über Sportsbooks hinweg gegen Pinnacle. Ein Soft Book mit einer höheren fairen Wahrscheinlichkeit auf der gespielten Seite hat lockerer geschlossen — positiver CLV.

Line-Shopping-Audit: Rufen Sie Closing Lines mehrerer Sportsbooks ab (bis zu fünf pro Anfrage), um zu verstehen, wo zum Schluss Value verfügbar war (mit canonical_key ordnen Sie dieselbe Auswahl über Sportsbooks hinweg zu).

Modellkalibrierung: Verwenden Sie implied_probability und no_vig_probability als historische Ground Truth zur Kalibrierung Ihrer eigenen Wahrscheinlichkeitsmodelle.

Verwandte EndpointsPermalink zu diesem Abschnitt

Last updated on