Quoten-Momentaufnahme

Eine Momentaufnahme aktueller Quoten von Sportwettenanbietern abrufen.

GET /api/v1/odds

AuthentifizierungPermalink for this section

Erfordert einen API key. Verfügbar für alle Tarife.

Query-ParameterPermalink for this section

Markt-Kategorie-AliasePermalink for this section

Anstatt einzelne Markttypen aufzulisten, können Sie einen Kategorie-Alias verwenden, um eine Gruppe verwandter Märkte abzugleichen. Aliase und exakte Typen können in einer kommagetrennten Liste beliebig kombiniert werden.

# Alle "main"-Märkte abrufen (moneyline + spreads + totals)
curl "https://api.sharpapi.io/api/v1/odds?league=nba&market=main" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Alias mit exaktem Typ kombinieren
curl "https://api.sharpapi.io/api/v1/odds?league=nfl&market=spread,moneyline" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Alle Player-Prop-Märkte
curl "https://api.sharpapi.io/api/v1/odds?league=nba&market=props" \
  -H "X-API-Key: YOUR_API_KEY"

BeispielanfragenPermalink for this section

curl -X GET "https://api.sharpapi.io/api/v1/odds?league=nba&sportsbook=draftkings&market=moneyline" \
  -H "X-API-Key: YOUR_API_KEY"

// Alle NBA-Moneyline-Quoten mit cursorbasierter Paginierung abrufen (empfohlen)
async function fetchAllOdds() {
  const results = [];
  let cursor = null;
 
  do {
    const url = new URL('https://api.sharpapi.io/api/v1/odds');
    url.searchParams.set('league', 'nba');
    url.searchParams.set('sportsbook', 'draftkings');
    url.searchParams.set('market', 'moneyline');
    url.searchParams.set('limit', '200');
    if (cursor) url.searchParams.set('cursor', cursor);
 
    const { data, pagination } = await fetch(url, {
      headers: { 'X-API-Key': 'YOUR_API_KEY' }
    }).then(r => r.json());
 
    results.push(...data);
    cursor = pagination.has_more ? pagination.next_cursor : null;
  } while (cursor);
 
  return results;
}

import requests
 
# Alle NBA-Moneyline-Quoten mit cursorbasierter Paginierung abrufen (empfohlen)
def fetch_all_odds():
    results = []
    params = {'league': 'nba', 'sportsbook': 'draftkings', 'market': 'moneyline', 'limit': 200}
    cursor = None
 
    while True:
        if cursor:
            params['cursor'] = cursor
        resp = requests.get(
            'https://api.sharpapi.io/api/v1/odds',
            params=params,
            headers={'X-API-Key': 'YOUR_API_KEY'}
        ).json()
 
        results.extend(resp['data'])
        pagination = resp['pagination']
        if not pagination['has_more']:
            break
        cursor = pagination['next_cursor']
 
    return results

PaginierungPermalink for this section

Jede Antwort enthält sowohl next_cursor (stabil) als auch next_offset (Legacy) im pagination-Objekt. Verwenden Sie für sequenzielle Vollscans des Datensatzes immer next_cursor.

# Erste Seite — kein Cursor erforderlich
curl "https://api.sharpapi.io/api/v1/odds?league=nfl&limit=200" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Folgeseiten — next_cursor aus der vorherigen Antwort übergeben
curl "https://api.sharpapi.io/api/v1/odds?league=nfl&limit=200&cursor=eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0" \
  -H "X-API-Key: YOUR_API_KEY"

ErgebnisreihenfolgePermalink for this section

Ergebnisse werden in chronologischer Reihenfolge nach Event-Startzeit zurückgegeben — bereits laufende und die als Nächstes beginnenden Events zuerst, spätere danach. Events ohne Startzeit im Feed werden zuletzt einsortiert.

Eine einzelne Seite ist daher ein Ausschnitt des Spielplans, keine Stichprobe über die gesamte Ergebnismenge. Ein Sportsbook ohne Spiele, die innerhalb des von dieser Seite abgedeckten Spielplanabschnitts beginnen, erscheint nicht darauf — auch dann nicht, wenn es später am selben Tag viele passende Zeilen hat. Das ist das erwartete Verhalten und keine Lücke in der Abdeckung. Um zu prüfen, ob ein Buch einen Markt führt, filtern Sie mit ?sportsbook= oder grenzen Sie mit ?league= ein, statt eine ungefilterte erste Seite zu lesen.

Auf einer Seite mit Zeilen zeigt meta.books genau das: Ein in in_scope gelistetes Buch ohne Eintrag in in_page hat auf dieser Seite keine Zeilen geliefert — meist, weil seine Spiele außerhalb des Spielplanabschnitts liegen, den diese Seite abdeckt, und nicht, weil es den Markt nicht führt.

Cursor sind undurchsichtig — parsen oder konstruieren Sie sie nicht. Sie kodieren die Sortierposition des letzten Elements der aktuellen Seite und sind nur für dieselben Filterparameter gültig.

?offset=N funktioniert weiterhin für flache Paginierung (bis Offset 500) und ist für Einzelseitenanfragen oder direkten Positionszugriff geeignet. Über 500 hinaus gibt die API 400 offset_too_large zurück — der Server müsste sonst bei jeder Seite das gesamte gefilterte Ergebnis sortieren, was sich viel günstiger vermeiden als pro Anfrage optimieren lässt. Verwenden Sie für tiefere Zugriffe cursor.

{
  "error": {
    "code": "offset_too_large",
    "message": "offset must be <= 500; use `cursor=` from the previous response for deeper pagination",
    "max_offset": 500
  }
}

AntwortPermalink for this section

Erfolg (200)Permalink for this section

{
  "success": true,
  "data": [
    {
      "id": "draftkings_33483153_moneyline_PHO",
      "sportsbook": "draftkings",
      "event_id": "33483153",
      "sport": "basketball",
      "league": "nba",
      "home_team": "PHI 76ers",
      "away_team": "PHO Suns",
      "market_type": "moneyline",
      "selection": "PHO Suns",
      "selection_type": "away",
      "odds_american": -150,
      "odds_decimal": 1.667,
      "odds_probability": 0.60,
      "line": null,
      "event_start_time": "2026-01-26T19:00:00Z",
      "timestamp": "2026-01-26T02:10:24.125Z",
      "is_live": false
    },
    {
      "id": "draftkings_33483153_moneyline_PHI",
      "sportsbook": "draftkings",
      "event_id": "33483153",
      "sport": "basketball",
      "league": "nba",
      "home_team": "PHI 76ers",
      "away_team": "PHO Suns",
      "market_type": "moneyline",
      "selection": "PHI 76ers",
      "selection_type": "home",
      "odds_american": 130,
      "odds_decimal": 2.30,
      "odds_probability": 0.4348,
      "line": null,
      "event_start_time": "2026-01-26T19:00:00Z",
      "timestamp": "2026-01-26T02:10:24.125Z",
      "is_live": false
    }
  ],
  "meta": {
    "count": 2,
    "total": 3095,
    "books_available": ["draftkings", "fanduel", "betmgm", "caesars", "pinnacle"],
    "books_returned": ["draftkings"],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "has_more": true,
      "next_offset": 50,
      "next_cursor": "eyJlIjoiMzM0ODMxNTMiLCJiIjoiZHJhZnRraW5ncyIsIm0iOiJtb25leWxpbmUiLCJpIjoiZHJhZnRraW5nc18zMzQ4MzE1M19tb25leWxpbmVfUEhJIn0"
    },
    "updated_at": "2026-01-26T02:10:37.846Z",
    "filters": {
      "league": "nba",
      "sportsbook": "draftkings",
      "market": "moneyline"
    }
  }
}

Leere Ergebnisse (200): meta.storePermalink for this section

Eine leere Seite — 200 mit "data": [] und "count": 0 — kann zwei verschiedene Dinge bedeuten: Ihre Filter haben nichts getroffen, oder die antwortende Instanz hatte im Moment der Antwort nichts geladen (zum Beispiel während eines Store-Wechsels). Seit September 2026 sagt die Antwort, welcher Fall vorliegt. Immer wenn /odds null Zeilen zurückgibt, wird ein meta.store-Block angehängt, und reason ist das Feld, auf dem Sie verzweigen:

{
  "data": [],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 0,
    "has_more": false,
    "next_offset": null
  },
  "updated_at": "2026-09-07T02:41:18.552Z",
  "meta": {
    "store": {
      "generation": 5019,
      "ready": true,
      "books": 39,
      "rows": 810137,
      "reason": "no_match"
    }
  }
}

• Nur bei leeren Ergebnissen vorhanden. Eine Antwort mit Zeilen ist Byte für Byte unverändert und trägt kein meta.store; Parser, die data + pagination + updated_at lesen, funktionieren weiterhin.
• books und rows beschreiben den gesamten Snapshot, nicht Ihre Abfrage — rows: 810137 belegt, dass der Store befüllt war, und ist keine Anzahl dessen, was Sie getroffen hätten.
• Abfragen, die auf zwei oder mehr Sportsbooks aufgelöst werden, tragen zusätzlich meta.books (den aufgelösten Buchumfang: in_scope und die in_page-Zählungen pro Buch); meta.store wird daneben hinzugefügt. Dasselbe gilt für die leere Seite einer Dashboard-Buchauswahl, die auf gar kein Buch aufgelöst wurde — siehe Leere Sportsbook-Auswahl unten.
• Ein unbekannter Wert für league oder sportsbook wird mit 400 invalid_filter abgewiesen und nicht mit einer leeren Seite beantwortet. Andere Filter werden nicht gegen den Katalog geprüft: ein market_type oder eine event_id, die nirgends existiert, liefert eine gewöhnliche leere Seite mit reason: "no_match".

Beendete Events: event_status und completed_atPermalink for this section

Ein Client, der /odds?event_id=<id> nach Spielende weiter abfragt, erhält eine maßgebliche leere Seite — reason: "no_match" stimmt, sagt aber nicht, warum nichts getroffen wurde. Ist die Seite leer, weil das eine Event, auf das Sie gefiltert haben, beendet ist, sagt meta.store auch das. Dies ist die echte Antwort für ein MLB-Spiel, das in derselben Nacht zuvor zu Ende gegangen war (eine Ein-Buch-Abfrage, damit der Body kurz bleibt — eine Mehr-Buch-Abfrage trägt wie oben zusätzlich meta.books):

GET /api/v1/odds?event_id=mlb_twins_whitesox_2026-09-06_b3&sportsbook=pinnacle&limit=1

{
  "data": [],
  "pagination": {
    "limit": 1,
    "offset": 0,
    "count": 0,
    "has_more": false,
    "next_offset": null
  },
  "updated_at": "2026-09-07T10:04:34.951684418Z",
  "meta": {
    "store": {
      "generation": 13456,
      "ready": true,
      "books": 39,
      "rows": 947879,
      "reason": "no_match",
      "event_status": "final",
      "completed_at": "2026-09-07T02:09:37Z"
    }
  }
}

/events/mlb_twins_whitesox_2026-09-06_b3 lieferte im selben Moment status: "final" mit demselben completed_at — beide Endpoints lesen denselben Datensatz und können sich daher nicht widersprechen.

Das Signal wird nur angehängt, wenn alle folgenden Bedingungen erfüllt sind — andernfalls behält der Block seine gewöhnliche Form, und keiner der beiden Schlüssel ist vorhanden:

• Die Anfrage hat auf genau eine event_id gefiltert (eine kommagetrennte Liste erhält kein Signal — das Feld ist singulär).
• Die Seite ist leer mit reason: "no_match" (eine Seite mit warming oder store_empty trägt es nie — die Leere geht vom Store aus, und reason sagt bereits, dass Sie es erneut versuchen sollen).
• Das Event ist bekanntermaßen beendet. Ein Event, das noch live oder bevorstehend ist, oder eine ID, die nirgends existiert, erhält ein gewöhnliches no_match ohne event_status — eine Ein-ID-Abfrage, die ohne dieses Feld beantwortet wird, bedeutet also entweder eine falsche ID oder ein Event, das noch nicht beendet ist.

Ein beendetes Event, dessen Quoten noch im Cache liegen, liefert diese Zeilen wie gewohnt; das Signal erscheint, sobald die Seite leer wird. completed_at ist der Zeitpunkt, zu dem der Abschluss erkannt wurde — typischerweise einige Minuten, nachdem das Event den Live-Feed verlassen hat — und nicht der Schlusspfiff; derselbe Vorbehalt wie bei completed_at in /events. Der Statuscode ändert sich nie: Ein Client, der ein Event über seine gesamte Laufzeit abfragt, erhält weiterhin 200.

Leere Sportsbook-Auswahl: meta.books.reasonPermalink for this section

Wenn die in Ihrem Dashboard gespeicherte Sportsbook-Auswahl auf nichts aufgelöst wird — jedes ausgewählte Buch fehlt im aktuellen Snapshot oder ist in Ihrem Tarif nicht enthalten —, wird eine ungefilterte /odds-Anfrage mit einer leeren Seite beantwortet. Der Store ist in Ordnung; die Auswahl ist der Grund, und die Antwort nennt ihn. meta.books — normalerweise nur bei Abfragen vorhanden, die auf zwei oder mehr Sportsbooks aufgelöst werden — wird mit leerem Umfang, reason: "selection_disjoint" und selected ausgegeben, der Auswahl, die auf nichts aufgelöst wurde (kanonische Sportsbook-IDs, sortiert):

{
  "data": [],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 0,
    "has_more": false,
    "next_offset": null
  },
  "updated_at": "2026-09-07T10:04:34.951684418Z",
  "meta": {
    "books": {
      "in_scope": [],
      "in_page": {},
      "reason": "selection_disjoint",
      "selected": ["betano", "bwin"]
    },
    "store": {
      "generation": 13454,
      "ready": true,
      "books": 39,
      "rows": 947919,
      "reason": "no_match"
    }
  }
}

• meta.books.reason hat Vorrang. meta.store wird weiterhin daneben ausgegeben, mit reason: "no_match" — zutreffend für den Store (er ist befüllt), aber nicht die Ursache. Ist meta.books.reason vorhanden, ist das der Grund für die leere Seite; ein erneuter Versuch ändert die Antwort nicht. Korrigieren Sie die Auswahl in Ihrem Dashboard, oder führen Sie ein Upgrade durch, wenn die ausgewählten Bücher einen höheren Tarif erfordern.
• in_scope und in_page sind vorhanden und leer ([] / {}, nie null). Der einzige reason-Wert ist derzeit selection_disjoint.
• Wird nur ausgegeben, wenn die Auswahl tatsächlich die Ursache ist: Die Anfrage trug keinen expliziten sportsbook=-Filter, Sie haben eine Dashboard-Auswahl, und Ihr Tarif allein hätte mindestens ein Buch ergeben. Es erscheint nie im Free-Tarif (der unabhängig von der Auswahl immer DraftKings und FanDuel liefert) und nie bei einem leeren oder aufwärmenden Store — diese Seiten erklärt meta.store.
• Mit einem expliziten sportsbook=-Filter wird dieselbe Diskrepanz abgewiesen statt mit einer leeren Seite beantwortet: 403 tier_restricted, 403 book_not_selected oder 503 book_unavailable.
• Seiten, die auf ein oder mehr Bücher aufgelöst werden, sind unverändert: Der Block für zwei oder mehr Bücher trägt weder reason noch selected, und ein Ein-Buch-Umfang trägt gar kein meta.books.

Antwort-HeaderPermalink for this section

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1737853200
X-Data-Delay: 0
X-Request-Id: req_abc123def456

FehlerantwortenPermalink for this section

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

403 Tier Restricted

{
  "error": {
    "code": "tier_restricted",
    "message": "Sportsbook 'pinnacle' requires Sharp tier or higher",
    "docs": "https://docs.sharpapi.io/en/pricing"
  }
}

429 Rate Limited

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 45 seconds.",
    "docs": "https://docs.sharpapi.io/en/authentication#rate-limits"
  }
}

Schema des Quoten-ObjektsPermalink for this section

SelektionstypenPermalink for this section

selection_type trägt die kanonische Seiten-Kennung für jede selection. Die meisten Märkte sind zweiseitig (z. B. Moneyline, Point Spread, Total) und emittieren einen der einfachen Werte unten. Eine kleine Menge an Mehrachsen-Märkten (Fußball Doppelchance, BTTS-kombiniert, Ergebnis × O/U, MMA Round Betting, Tennis Set Betting, korrekter Endstand usw.) kodiert zwei Outcomes pro Selektion und emittiert zusammengesetzte Werte, die mit _ verbunden sind.

Filterung nach QuotenbereichPermalink for this section

Verwenden Sie min_odds und max_odds, um nach American-Odds-Wert zu filtern.

# Nur Plus-Money-Quoten zurückgeben (+100 und höher)
curl "https://api.sharpapi.io/api/v1/odds?league=nba&min_odds=100" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Nur Quoten zwischen -200 und +200 zurückgeben
curl "https://api.sharpapi.io/api/v1/odds?league=nba&min_odds=-200&max_odds=200" \
  -H "X-API-Key: YOUR_API_KEY"

Nach Event gruppierte AntwortPermalink for this section

Verwenden Sie group_by=event, um Quoten nach Event statt als flache Liste zu gruppieren. Dies ist nützlich für den Aufbau eventzentrischer UIs.

curl "https://api.sharpapi.io/api/v1/odds?league=nba&group_by=event" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": [
    {
      "event_id": "33483153",
      "event_name": "PHI 76ers vs PHO Suns",
      "sport": "basketball",
      "league": "nba",
      "start_time": "2026-01-26T19:00:00Z",
      "is_live": false,
      "odds": [
        {
          "id": "draftkings_33483153_moneyline_PHO",
          "sportsbook": "draftkings",
          "market_type": "moneyline",
          "selection": "PHO Suns",
          "selection_type": "away",
          "odds_american": -150,
          "odds_decimal": 1.667,
          "odds_probability": 0.60,
          "line": null,
          "timestamp": "2026-01-26T02:10:24.125Z"
        }
      ]
    }
  ],
  "meta": {
    "group_by": "event",
    "books_available": 5,
    "filters": { "league": "nba" },
    "updated_at": "2026-01-26T02:10:37.846Z"
  }
}

Anbieterzugang nach TarifPermalink for this section

Welche Sportwettenanbieter in Ihren Quotenergebnissen enthalten sind, hängt von Ihrem Abonnement-Tarif ab:

FilterbeispielePermalink for this section

# Live-NBA-Quoten von allen verfügbaren Anbietern abrufen
curl "https://api.sharpapi.io/api/v1/odds?league=nba&is_live=true" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Moneyline- und Spread-Quoten für ein bestimmtes Event abrufen
curl "https://api.sharpapi.io/api/v1/odds?event_id=nba_76ers_suns_2026-01-26_b3&market=moneyline,spread" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Durch alle NFL-Spread-Quoten paginieren (verwenden Sie next_cursor aus jeder Antwort)
curl "https://api.sharpapi.io/api/v1/odds?league=nfl&market=spread&limit=200" \
  -H "X-API-Key: YOUR_API_KEY"

Verwandte EndpointsPermalink for this section

• Odds Delta - Nur Quoten abrufen, die sich seit einem bestimmten Zeitstempel geändert haben
• Best Odds - Die besten Quoten über alle Anbieter hinweg für jede Auswahl abrufen
• Odds Comparison - Quoten anbieterübergreifend nebeneinander vergleichen
• Batch Odds - Quoten für mehrere Events in einer Anfrage abrufen
• Markets - Verfügbare Markttypen auflisten
• Sportsbooks - Verfügbare Sportwettenanbieter und ihren Status auflisten