Skip to Content
API-ReferenzEvent-Quoten

Event-Quoten

Ruft alle Quoten für ein bestimmtes Event ab, mit optionaler Filterung nach Sportsbook und Markttyp. Gibt eine paginierte Liste von Quoteneinträgen zurück.

GET /api/v1/events/{eventId}/odds

Dies ist ein Convenience-Endpoint, der GET /api/v1/odds?event_id={eventId} entspricht. Beide liefern dieselben Daten; verwenden Sie denjenigen, der zu Ihrer URL-Struktur passt.

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.

PfadparameterPermalink zu diesem Abschnitt

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

Query-ParameterPermalink zu diesem Abschnitt

ParameterTypStandardBeschreibung
sportsbookstringallFiltern nach Sportsbook. Kommagetrennt für mehrere (z. B. draftkings,pinnacle)
marketstringallFiltern nach Markttyp. Kommagetrennt für mehrere (z. B. moneyline,spread)
limitinteger50Ergebnisse pro Seite (max. 200)
offsetinteger0Paginierungs-Offset

Response-HeaderPermalink zu diesem Abschnitt

Alle Antworten enthalten Standard-Header für Rate Limit und Metadaten:

HeaderBeschreibung
X-RateLimit-LimitMaximale Anzahl an 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 Anfrage-Kennung zur Fehlersuche

Quoten-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
idstringEindeutige Quoten-Kennung
sportsbookstringSportsbook-Kennung (z. B. draftkings, pinnacle)
event_idstringÜbergeordnete Event-Kennung
market_typestringMarkttyp: moneyline, spread, total, player_prop usw.
selectionstringDie Auswahl (Teamname, Spielername, Over/Under)
selection_typestringhome, away, over, under
linenumber | nullLinienwert für Spread-/Total-Märkte, null bei Moneyline
odds.americannumberAmerican Odds (z. B. -110, +150)
odds.decimalnumberDezimalquoten (z. B. 1.909)
odds.probabilitynumberImplizite Wahrscheinlichkeit (z. B. 0.5238)
timestampstringISO-8601-Zeitpunkt, zu dem SharpAPI diese Quote zuletzt durch seine Pipeline aktualisiert hat — wird in jedem Ingest-Zyklus weitergeschaltet. Ein Feed-Aktualitäts- / Liveness-Signal; es ist NICHT der Zeitpunkt, zu dem sich der Preis zuletzt geändert hat. Siehe timestamp verstehen.
price_updated_atstring|undefinedISO-8601-Zeitpunkt, zu dem der Preis dieser Quote zuletzt aktualisiert wurde. Er rückt vor, wenn sich Preis, Linie, Live-Status, Aussetzung, Orderbuch oder verfügbare Größe ändern, nicht wenn SharpAPI eine unveränderte Zeile erneut liest. Fehlt, wenn die Zeile keine Änderungszeit hat. Siehe timestamp verstehen.

BeispielanfragenPermalink zu diesem Abschnitt

Alle Quoten für ein Event abrufenPermalink zu diesem Abschnitt

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

Filtern nach Sportsbook und MarktPermalink zu diesem Abschnitt

curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?sportsbook=draftkings,pinnacle&market=moneyline,spread" \ -H "X-API-Key: YOUR_API_KEY"

Durch alle Quoten paginierenPermalink zu diesem Abschnitt

# First page curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=0" \ -H "X-API-Key: YOUR_API_KEY" # Next page curl -X GET "https://api.sharpapi.io/api/v1/events/evt_nba_bos_lal_20260208/odds?limit=50&offset=50" \ -H "X-API-Key: YOUR_API_KEY"

AntwortPermalink zu diesem Abschnitt

Erfolg (200)Permalink zu diesem Abschnitt

{ "data": [ { "id": "dk_evt_nba_bos_lal_20260208_ml_home", "sportsbook": "draftkings", "event_id": "evt_nba_bos_lal_20260208", "market_type": "moneyline", "selection": "Boston Celtics", "selection_type": "home", "line": null, "odds": { "american": -180, "decimal": 1.556, "odds_probability": 0.643 }, "timestamp": "2026-02-08T12:05:00Z", "price_updated_at": "2026-02-08T11:41:23Z" }, { "id": "dk_evt_nba_bos_lal_20260208_ml_away", "sportsbook": "draftkings", "event_id": "evt_nba_bos_lal_20260208", "market_type": "moneyline", "selection": "Los Angeles Lakers", "selection_type": "away", "line": null, "odds": { "american": 155, "decimal": 2.55, "odds_probability": 0.392 }, "timestamp": "2026-02-08T12:05:00Z", "price_updated_at": "2026-02-08T11:41:23Z" }, { "id": "pin_evt_nba_bos_lal_20260208_ml_home", "sportsbook": "pinnacle", "event_id": "evt_nba_bos_lal_20260208", "market_type": "moneyline", "selection": "Boston Celtics", "selection_type": "home", "line": null, "odds": { "american": -175, "decimal": 1.571, "odds_probability": 0.636 }, "timestamp": "2026-02-08T12:03:00Z", "price_updated_at": "2026-02-08T10:17:45Z" }, { "id": "dk_evt_nba_bos_lal_20260208_spread_home", "sportsbook": "draftkings", "event_id": "evt_nba_bos_lal_20260208", "market_type": "spread", "selection": "Boston Celtics", "selection_type": "home", "line": -6.5, "odds": { "american": -110, "decimal": 1.909, "odds_probability": 0.524 }, "timestamp": "2026-02-08T12:05:00Z", "price_updated_at": "2026-02-08T11:41:23Z" }, { "id": "dk_evt_nba_bos_lal_20260208_total_over", "sportsbook": "draftkings", "event_id": "evt_nba_bos_lal_20260208", "market_type": "total", "selection": "Over", "selection_type": "over", "line": 224.5, "odds": { "american": -110, "decimal": 1.909, "odds_probability": 0.524 }, "timestamp": "2026-02-08T12:05:00Z", "price_updated_at": "2026-02-08T11:41:23Z" } ], "meta": { "count": 5, "total": 48, "pagination": { "limit": 50, "offset": 0, "has_more": false, "next_offset": null }, "updated_at": "2026-02-08T12:05:00Z", "filters": { "sportsbook": "all", "market": "all" } } }

FehlerantwortenPermalink zu diesem Abschnitt

404 Not Found

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

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" } }

429 Rate Limited

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

Verwandte EndpointsPermalink zu diesem Abschnitt

  • Events – Events auflisten und durchsuchen
  • Event-Details – Event-Details mit eingebetteten Marktdaten abrufen
  • Event-Märkte – Verfügbare Markttypen für ein Event auflisten
  • Quoten-Snapshot – Quoten über alle Events hinweg abrufen
  • Beste Quoten – Die besten Quoten über alle Sportsbooks hinweg abrufen
Last updated on