Events

Einheitlicher Endpoint zum Auflisten und Suchen von Events mit Filterung, Paginierung und Suche.


GET /api/v1/events

Dieser Endpoint ersetzt die bisherigen Endpoints /schedule, /events/live und /events/search. Die gesamte Funktionalität dieser Endpoints ist nun hier über Query-Parameter verfügbar. Siehe Migrationshinweise unten.

AuthentifizierungPermalink for this section

Erfordert einen API-Key über den X-API-Key-Header, den Authorization: Bearer-Header oder den api_key-Query-Parameter. Verfügbar in allen Tarifen.

Query-ParameterPermalink for this section

Parameter	Typ	Standard	Beschreibung
`sport`	string	alle	Filter nach Sportart. Kommagetrennt für mehrere Werte (z. B. `basketball,football`)
`league`	string	alle	Filter nach Liga. Kommagetrennt für mehrere Werte (z. B. `nba,nfl`)
`sportsbook`	string	alle	Filter nach Sportsbook (z. B. `draftkings,pinnacle`)
`live`	boolean	—	`true` = nur Live, `false` = nur Prematch, weglassen = beide
`has_score`	boolean	—	`true` = nur Events mit Live-Spielstand/-Ständen
`date`	string	—	Filter nach Datum im Format `YYYY-MM-DD`
`team`	string	—	Filter nach Teamname (Teilübereinstimmung, Groß-/Kleinschreibung wird ignoriert, unterstützt Aliasse wie `lakers`)
`q`	string	—	Suchanfrage, die Teamnamen oder Eventnamen abgleicht
`limit`	integer	50	Ergebnisse pro Seite (max. 200)
`offset`	integer	0	Paginierungs-Offset (max. 5000)

Query-Parameter verwenden die Singularform und kommagetrennte Werte für mehrere Werte: sport=basketball,football, nicht sports=basketball&sports=football.

Response-HeaderPermalink for this section

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

Header	Beschreibung
`X-RateLimit-Limit`	Maximale 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 Request-Kennung zur Fehlersuche

Event-ObjektPermalink for this section

Feld	Typ	Beschreibung
`id`	string	Kanonische Event-Kennung — für jedes Sportsbook, das dieses Event abdeckt, identisch. Verwenden Sie diese als Primärschlüssel für den Abgleich zwischen Sportsbooks. Siehe Event-Matching.
`external_ids`	object	Zuordnung von Sportsbook-ID zur nativen Event-ID des jeweiligen Sportsbooks (z. B. `{"draftkings": "33483153"}`). Verwenden Sie diese für Deep Links zurück zu den Sportsbook-Seiten.
`sport`	string	Sportart-Kennung (z. B. `basketball`, `football`)
`league`	string	Liga-Slug (z. B. `nba`, `nfl`)
`home_team`	string	Name des Heim-Teams
`away_team`	string	Name des Auswärts-Teams
`start_time`	string	ISO-8601-Startzeit des Events
`status`	string	Event-Status: `upcoming` oder `live`
`is_live`	boolean	Gibt an, ob das Event derzeit live ist
`book_count`	integer	Anzahl der Sportsbooks mit Quoten für dieses Event
`markets`	string[]	Sortiertes Array der verfügbaren Markttypen (z. B. `["moneyline", "point_spread", "total_points"]`)
`books`	string[]	Sortiertes Array der Sportsbook-IDs mit Quoten für dieses Event
`game_state`	object \| undefined	Live-Spielstand (nur vorhanden bei Live-Events mit Ständen)

Game-State-ObjektPermalink for this section

Enthalten, wenn das Event live ist und Score-Daten vorliegen:

Feld	Typ	Beschreibung
`home_score`	number	Punktzahl des Heim-Teams
`away_score`	number \| null	Punktzahl des Auswärts-Teams
`period`	string \| null	Aktuelle Periode (z. B. `Q3`, `2nd`, `3rd Period`)
`clock`	string \| null	Verbleibende Zeit (z. B. `5:42`)
`score_type`	string	Score-Typ (z. B. `game_points`, `match`)
`possession`	string \| null	Team mit Ballbesitz (`home` oder `away`)
`is_timeout`	boolean \| null	Gibt an, ob ein Timeout läuft
`power_play`	string \| null	Power-Play-Information (`home` oder `away`, Eishockey)
`last_play`	string \| null	Beschreibung des letzten Spielzugs

BeispielanfragenPermalink for this section

Bevorstehende NBA- und NFL-Events auflistenPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events?sport=basketball,football&league=nba,nfl&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/events?sport=basketball,football&league=nba,nfl&limit=20',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();
console.log(`Found ${meta.total} events, showing ${meta.count}`);

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/events',
    params={
        'sport': 'basketball,football',
        'league': 'nba,nfl',
        'limit': 20
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
data = response.json()
print(f"Found {data['meta']['total']} events")

Nur Live-Events abrufenPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events?live=true" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/events?live=true',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
console.log(`${data.length} live events`);

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/events',
    params={'live': 'true'},
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
live_events = response.json()['data']

Nach einem Team suchenPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events?q=celtics" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/events?q=celtics',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/events',
    params={'q': 'celtics'},
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
results = response.json()['data']

Nach Datum und Sportsbook filternPermalink for this section

cURL


curl -X GET "https://api.sharpapi.io/api/v1/events?date=2026-02-08&sportsbook=draftkings,fanduel" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript


const response = await fetch(
  'https://api.sharpapi.io/api/v1/events?date=2026-02-08&sportsbook=draftkings,fanduel',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data, meta } = await response.json();

Python


import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/events',
    params={
        'date': '2026-02-08',
        'sportsbook': 'draftkings,fanduel'
    },
    headers={'X-API-Key': 'YOUR_API_KEY'}
)
data = response.json()

AntwortPermalink for this section

Erfolg (200)Permalink for this section


{
  "data": [
    {
      "id": "evt_nba_bos_lal_20260208",
      "external_ids": {
        "draftkings": "33483200",
        "fanduel": "nba-bos-lal-20260208"
      },
      "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,
      "book_count": 6,
      "markets": ["moneyline", "point_spread", "total_points"],
      "books": ["betmgm", "caesars", "draftkings", "fanduel"]
    },
    {
      "id": "evt_nba_gsw_mia_20260208",
      "external_ids": {
        "draftkings": "33483205"
      },
      "sport": "basketball",
      "league": "nba",
      "home_team": "Golden State Warriors",
      "away_team": "Miami Heat",
      "start_time": "2026-02-08T22:00:00Z",
      "status": "upcoming",
      "is_live": false,
      "book_count": 5,
      "markets": ["moneyline", "point_spread", "total_points"],
      "books": ["betmgm", "draftkings", "fanduel"]
    }
  ],
  "meta": {
    "count": 2,
    "total": 43,
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": true,
      "next_offset": 50
    },
    "updated_at": "2026-02-08T12:00:00Z",
    "filters": {
      "sport": ["basketball"],
      "league": ["nba"]
    }
  }
}

FehlerantwortenPermalink for this section

401 Unauthorized


{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "docs": "https://docs.sharpapi.io/en/authentication"
  }
}

400 Bad Request


{
  "error": {
    "code": "validation_error",
    "message": "Invalid date format. Use YYYY-MM-DD.",
    "docs": "https://docs.sharpapi.io/en/api-reference/events"
  }
}

429 Rate Limited


{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Upgrade your tier for higher limits.",
    "docs": "https://docs.sharpapi.io/en/pricing"
  }
}

Migration von früheren EndpointsPermalink for this section

Mehrere veraltete Event-Unterpfade aus früheren API-Versionen werden als Hinweis auf die Veraltung beibehalten — beim Aufruf wird 410 Gone mit einem maschinenlesbaren Hinweis zurückgegeben, der auf den korrekten Endpoint verweist.

Veralteter Pfad	Stattdessen verwenden
`GET /events/search?q=celtics`	`GET /events?q=celtics`
`GET /events/list`	`GET /events`
`GET /events/all`	`GET /events`
`GET /events/find`	`GET /events`

Aufbau der 410-AntwortPermalink for this section


{
  "error": {
    "code": "unknown_endpoint",
    "message": "There is no /api/v1/events/search endpoint. Use GET /api/v1/events — results can be filtered with ?sport=, ?league=, and ?book= query parameters.",
    "correct_endpoint": "/api/v1/events",
    "docs": "https://docs.sharpapi.io/api-reference"
  }
}

Antworten vor v1 verwendeten Feldnamen in camelCase (homeTeam, awayTeam, isLive, bookCount). Die v1-API verwendet ausschließlich snake_case (home_team, away_team, is_live, book_count). Aktualisieren Sie Ihren Client-Code entsprechend.

Wesentliche Änderungen gegenüber früheren VersionenPermalink for this section

Feldnamen sind nun in snake_case (z. B. home_team anstelle von homeTeam)
Die Antwort verwendet das standardmäßige data/meta-Envelope anstelle eines events-Arrays auf oberster Ebene
Query-Parameter verwenden die Singularform (sport anstelle von sports)
Die Basis-URL lautet https://api.sharpapi.io (nicht https://sharpapi.io)
Die Paginierung umfasst nun die Felder has_more und next_offset

Event-Matching über mehrere Sportsbooks hinwegPermalink for this section

Das Feld id ist eine kanonische Event-Kennung — dasselbe reale Event erhält dieselbe id, unabhängig davon, von welchem Sportsbook es stammt. Verwenden Sie sie als Primärschlüssel beim Erstellen von Vergleichstools über mehrere Sportsbooks hinweg. Das Feld external_ids ordnet jedem Sportsbook seine native Event-ID für Deep Links zu.

Vollständige Details zur Funktionsweise kanonischer IDs finden Sie unter Event-Matching.

Events

AuthentifizierungPermalink for this section

Query-ParameterPermalink for this section

Response-HeaderPermalink for this section

Event-ObjektPermalink for this section

Game-State-ObjektPermalink for this section

BeispielanfragenPermalink for this section

Bevorstehende NBA- und NFL-Events auflistenPermalink for this section

cURL

JavaScript

Python

Nur Live-Events abrufenPermalink for this section

cURL

JavaScript

Python

Nach einem Team suchenPermalink for this section

cURL

JavaScript

Python

Nach Datum und Sportsbook filternPermalink for this section

cURL

JavaScript

Python

AntwortPermalink for this section

Erfolg (200)Permalink for this section

FehlerantwortenPermalink for this section

Migration von früheren EndpointsPermalink for this section

Aufbau der 410-AntwortPermalink for this section

Wesentliche Änderungen gegenüber früheren VersionenPermalink for this section

Event-Matching über mehrere Sportsbooks hinwegPermalink for this section

Verwandte EndpointsPermalink for this section