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/closingEnterprise-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
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
date | string | Ja | Datum im Format YYYY-MM-DD (UTC). |
sport | string | Ja | Sport-Identifikator, z. B. baseball, basketball, football. |
league | string | Ja | Liga-Identifikator, z. B. mlb, nba, nfl. |
sportsbook | string | Ja | Eine 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_id | string | Nein | Liefert nur dieses Event aus den Events des Datums. Ohne den Parameter kommt jedes Event des Datums zurück. |
include_degraded | boolean | Nein | Standard 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
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
| Feld | Typ | Beschreibung |
|---|---|---|
date | string | Das angefragte Datum (YYYY-MM-DD) |
sport | string | Angewandter Sport-Filter |
league | string | Angewandter Liga-Filter |
events | array | null | Closing-Line-Events, die dem Datum, Sport und der Liga entsprechen, nur mit den angefragten Sportsbooks. null, wenn keine passen. |
total_events | integer | Anzahl der Events in der Antwort |
total_lines | integer | Gesamtzahl der einzelnen Closing Lines über alle Events und Sportsbooks |
Event-ObjektPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
event_id | string | Kanonischer Event-Identifikator |
sport | string | Sport |
league | string | Liga |
home_team | string | Name des Heimteams |
away_team | string | Name des Auswärtsteams |
event_start_time | string | Geplante Startzeit im ISO-8601-Format |
captured_at | string | ISO-8601-Zeitstempel der ersten Closing-Line-Erfassung für dieses Event |
books | object | Map von Sportsbook-ID → Closing-Payload pro Sportsbook (siehe unten) |
Payload pro Sportsbook (books[<sportsbook>])Permalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
odds | array | Closing-Line-Einträge für dieses Sportsbook (siehe unten) |
captured_at | string | ISO-8601-Zeitpunkt, zu dem die Closing Line dieses Sportsbooks erfasst wurde |
seconds_before_kickoff | integer | Sekunden 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_trigger | string | Auslöser der Erfassung: transition | kickoff | disappearance | evict | backfill (Konfidenzreihenfolge: transition > kickoff > andere) |
is_final | boolean | Ob 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.
| Feld | Typ | Beschreibung |
|---|---|---|
sportsbook | string | Sportsbook-ID |
market_type | string | Markttyp: moneyline, point_spread, total_runs, player_earned_runs, etc. |
market_id | string | Nativer Markt-Identifikator des Sportsbooks |
selection | string | Auswahlbezeichnung (Teamname, Over/Under, Spieler) |
selection_type | string | home, away, over, under, etc. |
selection_id | string | Nativer Auswahl-Identifikator des Sportsbooks |
canonical_key | string | Stabiler, 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. |
line | number | Spread- oder Total-Wert (-3.5, 2.5). Weggelassen bei Moneylines und anderen Märkten ohne Linie. |
odds_american | integer | American Odds beim Schluss |
odds_decimal | number | Decimal Odds beim Schluss |
implied_probability | number | Rohe implizite Wahrscheinlichkeit (mit Vig) |
no_vig_probability | number | Proportional 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_decimal | number | Fairer (No-Vig) Decimal-Preis beim Schluss. Genau dann vorhanden, wenn no_vig_probability vorhanden ist. |
closing_probability | number | Power-devigte faire Closing-Wahrscheinlichkeit (der für CLV verwendete Wert). Weggelassen, wenn kein komplementäres Paar verfügbar war. |
source_updated_at | string | ISO-8601-Zeitstempel, zu dem der Quell-Odds-Datensatz upstream zuletzt als aktuell bestätigt wurde (zuletzt aktiv gesehen, nicht letzte Preisänderung) |
player_name | string | Spielername — nur Player-Prop-Märkte |
stat_category | string | Statistikkategorie des Player Props (z. B. earned_runs, total_bases) — nur Player-Prop-Märkte |
team_side | string | home | away | draw — die Team-Achse für teamgebundene Zeilen (Moneylines, Team-Totals). Fehlt, wenn nicht teamgebunden. |
market_segment | string | Spielabschnitt, den der Markt abdeckt (1st_half, 1st_5_innings, …). Fehlt bei Märkten für das ganze Spiel. |
max_bet | number | Maximaler Einsatz des Sportsbooks auf diese Auswahl beim Schluss — nur bei Sportsbooks, die Limits veröffentlichen (z. B. Pinnacle) |
odds_after_kickoff | boolean | true, 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
| Feld | Typ | Beschreibung |
|---|---|---|
source | string | Backing Store — "clickhouse" |
tier_window_days | string | Lookback-Fenster — "unlimited" im Enterprise-Tier: keine rollierende Grenze, zurück bis zum Archivstart am 2026-04-23 |
filters | object | Echo der angewandten Filter: sport, league, date, sportsbook (ein Array der Sportsbooks in Anfragereihenfolge) und event_id (null, wenn nicht gesendet) |
updated_at | string | ISO-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
- Closing Line Value (CLV) — Aggregierte CLV%-Rollups gruppiert nach Sportsbook, Sport, Liga oder Tag
- Closing Line — Aktuelle bzw. jüngste Closing-Erfassung (Pro+, Echtzeit)
- Odds Snapshot — Aktuelle Echtzeit-Odds
- +EV-Möglichkeiten — Echtzeit-Wetten mit positivem Erwartungswert