Skip to Content
API-ReferenzEvent-Details

Event-Details

Detaillierte Informationen zu einem einzelnen Event abrufen, einschließlich verfügbarer Märkte und Metadaten.

GET /api/v1/events/{eventId}

AuthentifizierungPermalink zu diesem Abschnitt

Erfordert einen API key über den X-API-Key-Header, den Authorization: Bearer-Header oder den api_key-Query-Parameter. Verfügbar für alle Tarife.

Pfad-ParameterPermalink zu diesem Abschnitt

ParameterTypErforderlichBeschreibung
eventIdstringJaEindeutige Event-Kennung (z. B. evt_nba_bos_lal_20260208)

Response-HeaderPermalink zu diesem Abschnitt

Alle Antworten enthalten standardmäßige Rate-Limit- und Metadaten-Header:

HeaderBeschreibung
X-RateLimit-LimitMaximale Anzahl von Anfragen pro Minute für Ihren Tarif
X-RateLimit-RemainingVerbleibende Anfragen im aktuellen Zeitfenster
X-RateLimit-ResetUnix-Zeitstempel, wann das Rate-Limit-Fenster zurückgesetzt wird
X-Data-DelayDatenverzögerung für Ihren Tarif (z. B. 0s, 60s)
X-Request-IdEindeutige Anfragen-Kennung zur Fehlersuche

Event-Detail-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
idstringKanonische Event-Kennung — identisch für jeden Sportsbook, der dieses Event abdeckt. Verwenden Sie diese als Primärschlüssel für den Abgleich zwischen Sportsbooks. Siehe Event-Matching.
external_idsobjectZuordnung der Sportsbook-ID zur nativen Event-ID des jeweiligen Sportsbooks (z. B. { "draftkings": "12345", "fanduel": "67890" }). Verwenden Sie diese für Deep-Links zurück zu den Sportsbook-Seiten.
sportstringSportarten-Kennung (z. B. basketball, football)
leaguestringLiga-Name (z. B. NBA, NFL)
home_teamstringName des Heimteams
away_teamstringName des Auswärtsteams
start_timestringISO 8601-Startzeit des Events. Fehlt bei einem abgeschlossenen Event aus dem Retention-Speicher — prüfen Sie auf das Vorhandensein des Schlüssels, nicht auf status.
completed_atstringISO-8601-Abschlusszeit. Nur bei Zeilen mit status: "final" vorhanden.
statusstringEvent-Status: upcoming, live, final oder unconfirmed. Der Status ist live, wenn unser Spiel-Tracking zeigt, dass das Spiel läuft, oder wenn mehrere Sportsbooks Live-Preise darauf anbieten. unconfirmed bedeutet, dass der Live-Feed das Spiel nicht mehr geführt hat, bevor er einen Spielende-Zustand zeigte. Der zuletzt gesehene Spielstand ist kein Endergebnis, is_live ist false und es gibt kein completed_at. Unter den Events-Endpoints liefert nur dieser unconfirmed; die /events-Liste nie, und ?status=unconfirmed ist dort kein Filterwert. Live-Spielstatus zeigt dasselbe Spiel als unbestätigte Zeile.
is_livebooleanOb das Spiel live ist: true, wenn status live ist.
live_book_countintegerWie viele Sportsbooks mindestens einen Live-Preis auf dieses Event haben. Immer vorhanden, 0, wenn keines. Kann auch über 0 liegen, wenn das Event nicht live ist. Bei einem live-Event bedeutet 0, dass allein unser Spiel-Tracking zeigt, dass das Spiel läuft.
season_typestring"Preseason" oder "Regular Season". Fehlt, wenn es nicht bekannt ist: eine Liga ohne veröffentlichten Saisonkalender (derzeit jede Liga außer nba), ein Datum außerhalb des Kalenders oder ein Event ohne Startzeit. Ein fehlendes Feld bedeutet nie reguläre Saison.
event_groupstringCard- oder Turnierbezeichnung, die die Sportsbooks veröffentlichen (z. B. UFC Fight Night), derselbe Wert wie in der /events-Liste. Fehlt, wenn kein Buch eine sendet, und bei manchen beendeten Events.
event_group_slugstringevent_group in URL-sicherer Form (z. B. ufc-fight-night). Genau dann vorhanden, wenn event_group vorhanden ist.
booksarraySportsbooks, die dieses Event abdecken, sortiert nach Markt-Anzahl absteigend
marketsarrayMarkttypen, die für dieses Event verfügbar sind, sortiert nach Auswahl-Anzahl absteigend
last_seenobjectNur vorhanden, wenn status unconfirmed ist und Ihr Schlüssel das Game State Add-on oder Enterprise hat. Der letzte Spielstand, den der Live-Feed zeigte, siehe unten.
resultobjectNur vorhanden, wenn status final ist und Ihr Schlüssel das Game State Add-on oder Enterprise hat. Das Endergebnis, siehe unten.
result_accessstringNur vorhanden, wenn status final oder unconfirmed ist. granted: Ihr Schlüssel erhält result (bei final) bzw. last_seen (bei unconfirmed). requires_game_state_addon: dieses Objekt wird für Ihren Schlüssel zurückgehalten.
sourcestringconfirmed bei einem final-Event, dessen Ergebnis bestätigt wurde, nachdem der Live-Feed das Spiel nicht mehr führte. Fehlt, wenn der Live-Feed das Spielende gezeigt hat.

Books-ArrayPermalink zu diesem Abschnitt

Jeder Eintrag im books-Array beschreibt einen Sportsbook, der Quoten für dieses Event hat.

FeldTypBeschreibung
idstringSportsbook-Kennung (z. B. draftkings, pinnacle)
namestringAnzeigename des Sportsbooks
market_countintegerAnzahl der unterschiedlichen Markttypen, die dieser Sportsbook für das Event anbietet
last_updatestringISO 8601-Zeitstempel der letzten Quotenaktualisierung dieses Sportsbooks

Markets-ArrayPermalink zu diesem Abschnitt

Jeder Eintrag im markets-Array fasst einen verfügbaren Markttyp für dieses Event zusammen.

FeldTypBeschreibung
typestringMarkttyp-Kennung (z. B. moneyline, spread, total, player_prop)
selection_countintegerAnzahl der unterschiedlichen Auswahlmöglichkeiten in diesem Markt
book_countintegerAnzahl der Sportsbooks, die diesen Markt anbieten

Last-Seen-ObjektPermalink zu diesem Abschnitt

Nur bei einem unconfirmed-Event vorhanden, und nur für einen Schlüssel mit dem Game State Add-on oder Enterprise. Ohne das Add-on antwortet das Event weiterhin mit status: "unconfirmed", aber ohne last_seen. Es enthält den letzten Frame, den der Live-Feed zeigte, bevor er das Spiel nicht mehr führte, zum Beispiel 97-81 bei Q4 4:59. Es ist kein Endergebnis; behandeln Sie es nicht als Resultat.

FeldTypBeschreibung
home_scoreintegerPunktestand des Heimteams im zuletzt gesehenen Frame. Eine Satzzahl, wenn score_type sets ist
away_scoreintegerPunktestand des Auswärtsteams im zuletzt gesehenen Frame. Eine Satzzahl, wenn score_type sets ist
score_typestringsets für Tennis, Tischtennis, Volleyball und Badminton; points für alle anderen Sportarten
game_periodstringSpielabschnitt im zuletzt gesehenen Frame (z. B. Q4). Fehlt, wenn der Feed keinen geliefert hat
game_clockstringSpieluhr im zuletzt gesehenen Frame (z. B. 4:59). Fehlt, wenn der Feed keine geliefert hat
seen_atstringISO-8601-Zeitpunkt, zu dem der Live-Feed das Spiel zuletzt zeigte

Result-ObjektPermalink zu diesem Abschnitt

Nur bei einem final-Event vorhanden, und nur für einen Schlüssel mit dem Game State Add-on oder Enterprise. Ohne das Add-on antwortet das Event weiterhin mit status: "final" und completed_at, mit result_access: "requires_game_state_addon" und ohne result. Es ist nie null oder mit Nullen gefüllt, ein fehlendes result bedeutet also nie ein 0:0.

FeldTypBeschreibung
event_idstringDie Event-ID
sportstringSportart-Kennung
leaguestringLiga-Slug
home_teamstringName des Heimteams
away_teamstringName des Auswärtsteams
final_home_scoreintegerEndstand des Heimteams. Eine Satzzahl, wenn score_type sets ist
final_away_scoreintegerEndstand des Auswärtsteams. Eine Satzzahl, wenn score_type sets ist
winnerstringhome, away oder draw. Fehlt, wenn der Sieger nicht feststellbar ist
score_typestringsets für Tennis, Tischtennis, Volleyball und Badminton; points für alle anderen Sportarten. Fehlt bei einem älteren Datensatz, dessen Zählweise nicht feststellbar ist
period_scoresobjectEndstand je Spielabschnitt, nach Abschnittsbezeichnung (z. B. Q1, OT, 1H, SETS), jeweils { "home", "away" }. Fehlt, wenn keine Aufschlüsselung vorliegt
event_completed_atstringDerselbe Wert wie completed_at des Events

BeispielanfragenPermalink zu diesem Abschnitt

curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208" \ -H "X-API-Key: YOUR_API_KEY"

AntwortPermalink zu diesem Abschnitt

Erfolg (200)Permalink zu diesem Abschnitt

Antworten für Einzelressourcen umschließen das Objekt in data als einzelnes Objekt (nicht als Array).

{ "data": { "id": "evt_nba_bos_lal_20260208", "external_ids": { "draftkings": "12345678", "fanduel": "87654321", "pinnacle": "556677889", "betmgm": "ms_44556" }, "sport": "basketball", "league": "NBA", "home_team": "Boston Celtics", "away_team": "Los Angeles Lakers", "start_time": "2026-02-08T19:30:00Z", "status": "upcoming", "is_live": false, "live_book_count": 0, "books": [ { "id": "draftkings", "name": "DraftKings", "market_count": 5, "last_update": "2026-02-08T12:05:00Z" }, { "id": "fanduel", "name": "FanDuel", "market_count": 4, "last_update": "2026-02-08T12:04:30Z" }, { "id": "pinnacle", "name": "Pinnacle", "market_count": 3, "last_update": "2026-02-08T12:03:00Z" }, { "id": "betmgm", "name": "BetMGM", "market_count": 3, "last_update": "2026-02-08T12:02:15Z" } ], "markets": [ { "type": "moneyline", "selection_count": 2, "book_count": 4 }, { "type": "spread", "selection_count": 2, "book_count": 4 }, { "type": "total", "selection_count": 2, "book_count": 3 }, { "type": "player_prop", "selection_count": 18, "book_count": 2 }, { "type": "team_total", "selection_count": 4, "book_count": 1 } ] }, "meta": { "event_id": "evt_nba_bos_lal_20260208" } }

FehlerantwortenPermalink zu diesem Abschnitt

404 Not Found

{ "error": { "code": "not_found", "message": "Event not found", "docs": "https://docs.sharpapi.io/en/api-reference/events-by-id" } }

401 Unauthorized

Ohne Schlüssel wird missing_api_key zurückgegeben; ein ungültiger Schlüssel ergibt invalid_api_key.

{ "error": { "code": "missing_api_key", "message": "API key required. Pass via X-API-Key header, api_key query parameter, or Bearer token.", "docs": "https://docs.sharpapi.io/en/authentication" } }

AnwendungsfällePermalink zu diesem Abschnitt

  • Vergleich zwischen Sportsbooks — Die kanonische id ist über alle Sportsbooks hinweg identisch, sodass alle zurückgegebenen Quoten bereits demselben realen Event zugeordnet sind. Siehe Event-Matching.
  • Marktanalyse — Sehen Sie jeden verfügbaren Markttyp und wie viele Sportsbooks ihn jeweils anbieten
  • Sharp-Referenz — Vergleichen Sie Quoten von Soft Books mit Pinnacle (dem Sharp-Benchmark)
  • Deep-Linking — Verwenden Sie external_ids, um Nutzer zur Event-Seite eines bestimmten Sportsbooks zu leiten

Verwandte EndpointsPermalink zu diesem Abschnitt

Last updated on