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
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
eventId | string | Ja | Eindeutige Event-Kennung (z. B. evt_nba_bos_lal_20260208) |
Response-HeaderPermalink zu diesem Abschnitt
Alle Antworten enthalten standardmäßige Rate-Limit- und Metadaten-Header:
| Header | Beschreibung |
|---|---|
X-RateLimit-Limit | Maximale Anzahl von Anfragen pro Minute für Ihren Tarif |
X-RateLimit-Remaining | Verbleibende Anfragen im aktuellen Zeitfenster |
X-RateLimit-Reset | Unix-Zeitstempel, wann das Rate-Limit-Fenster zurückgesetzt wird |
X-Data-Delay | Datenverzögerung für Ihren Tarif (z. B. 0s, 60s) |
X-Request-Id | Eindeutige Anfragen-Kennung zur Fehlersuche |
Event-Detail-ObjektPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Kanonische 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_ids | object | Zuordnung 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. |
sport | string | Sportarten-Kennung (z. B. basketball, football) |
league | string | Liga-Name (z. B. NBA, NFL) |
home_team | string | Name des Heimteams |
away_team | string | Name des Auswärtsteams |
start_time | string | ISO 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_at | string | ISO-8601-Abschlusszeit. Nur bei Zeilen mit status: "final" vorhanden. |
status | string | Event-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_live | boolean | Ob das Spiel live ist: true, wenn status live ist. |
live_book_count | integer | Wie 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_type | string | "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_group | string | Card- 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_slug | string | event_group in URL-sicherer Form (z. B. ufc-fight-night). Genau dann vorhanden, wenn event_group vorhanden ist. |
books | array | Sportsbooks, die dieses Event abdecken, sortiert nach Markt-Anzahl absteigend |
markets | array | Markttypen, die für dieses Event verfügbar sind, sortiert nach Auswahl-Anzahl absteigend |
last_seen | object | Nur 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. |
result | object | Nur vorhanden, wenn status final ist und Ihr Schlüssel das Game State Add-on oder Enterprise hat. Das Endergebnis, siehe unten. |
result_access | string | Nur 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. |
source | string | confirmed 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.
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Sportsbook-Kennung (z. B. draftkings, pinnacle) |
name | string | Anzeigename des Sportsbooks |
market_count | integer | Anzahl der unterschiedlichen Markttypen, die dieser Sportsbook für das Event anbietet |
last_update | string | ISO 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.
| Feld | Typ | Beschreibung |
|---|---|---|
type | string | Markttyp-Kennung (z. B. moneyline, spread, total, player_prop) |
selection_count | integer | Anzahl der unterschiedlichen Auswahlmöglichkeiten in diesem Markt |
book_count | integer | Anzahl 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.
| Feld | Typ | Beschreibung |
|---|---|---|
home_score | integer | Punktestand des Heimteams im zuletzt gesehenen Frame. Eine Satzzahl, wenn score_type sets ist |
away_score | integer | Punktestand des Auswärtsteams im zuletzt gesehenen Frame. Eine Satzzahl, wenn score_type sets ist |
score_type | string | sets für Tennis, Tischtennis, Volleyball und Badminton; points für alle anderen Sportarten |
game_period | string | Spielabschnitt im zuletzt gesehenen Frame (z. B. Q4). Fehlt, wenn der Feed keinen geliefert hat |
game_clock | string | Spieluhr im zuletzt gesehenen Frame (z. B. 4:59). Fehlt, wenn der Feed keine geliefert hat |
seen_at | string | ISO-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.
| Feld | Typ | Beschreibung |
|---|---|---|
event_id | string | Die Event-ID |
sport | string | Sportart-Kennung |
league | string | Liga-Slug |
home_team | string | Name des Heimteams |
away_team | string | Name des Auswärtsteams |
final_home_score | integer | Endstand des Heimteams. Eine Satzzahl, wenn score_type sets ist |
final_away_score | integer | Endstand des Auswärtsteams. Eine Satzzahl, wenn score_type sets ist |
winner | string | home, away oder draw. Fehlt, wenn der Sieger nicht feststellbar ist |
score_type | string | sets 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_scores | object | Endstand je Spielabschnitt, nach Abschnittsbezeichnung (z. B. Q1, OT, 1H, SETS), jeweils { "home", "away" }. Fehlt, wenn keine Aufschlüsselung vorliegt |
event_completed_at | string | Derselbe Wert wie completed_at des Events |
BeispielanfragenPermalink zu diesem Abschnitt
cURL
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
idist ü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
- Events - Events auflisten und durchsuchen
- Event-Quoten - Paginierte Quoten für dieses Event abrufen
- Event-Märkte - Verfügbare Markttypen für dieses Event abrufen
- Quoten-Snapshot - Aktuelle Quoten für alle Events abrufen