Skip to Content
API-ReferenzEnterprise-Endpoints

Enterprise-Endpunkte

Erweiterte Endpunkte, die ausschließlich Abonnenten des Enterprise-Tarifs zur Verfügung stehen.

Alle Endpunkte auf dieser Seite erfordern ein Enterprise-Abonnement. Niedrigere Tarife erhalten einen 403 tier_restricted-Fehler.

FuturesPermalink zu diesem Abschnitt

Futures sind saisonlange Märkte: Meister, Konferenz- und Divisionssieger, MVP und andere Auszeichnungen, Siegesummen (Win Totals), Playoff-Teilnahme. Zwei Endpunkte liefern sie:

EndpunktLiefert
GET /api/v1/futuresDie Futures: jeweils mit ID, Name und den Sportsbooks, die sie anbieten
GET /api/v1/futures/oddsDie Futures mit ihren Quoten: eine Zeile pro Sportsbook, Auswahl, Wettseite und Linie

Rufen Sie die Futures ab, um die gewünschte ID zu finden, und übergeben Sie sie als future_id an den Quoten-Endpunkt.

Kanonische FuturesPermalink zu diesem Abschnitt

Sportsbooks benennen denselben Markt und dasselbe Team oder denselben Spieler unterschiedlich. SharpAPI ordnet die Version eines Futures bei jedem Sportsbook einem Future mit einer ID und einem Namen zu, und jede Schreibweise eines Teams oder Spielers einer Auswahl mit einem Namen. Die Preise eines Futures lassen sich dadurch Zeile für Zeile über Sportsbooks hinweg vergleichen.

  • ID. Die Liga-ID, zwei Unterstriche, dann der Name in Snake Case mit Kleinbuchstaben: nfl__super_bowl_winner, nba__regular_season_wins, england_-_premier_league__championship_winner. Entnehmen Sie IDs dem Katalog, statt sie zu bauen: Ein Name mit Jahreszahl (1st Overall Pick 2027) erhält eine neue ID, wenn sich das Jahr ändert.
  • Name. Ein Name pro Future in festem Stil: Super Bowl Winner, AFC South Winner, MVP Winner, Regular Season Wins.
  • Auswahl. Das Team oder der Spieler, auf den sich ein Preis bezieht, unter seinem einen kanonischen Namen: San Francisco 49ers, im Fußball der vollständige Vereinsname, Arsenal FC. normalized_selection ist dieser Name in einer Form für Joins.
  • Wettseite und Linie. Eine Zeile bepreist eine Seite einer Auswahl: over oder under bei einer Linie in einer Win-Total-Ladder, yes oder no, oder keine Seite bei einem Outright.
  • Future-Typ. TEAM, wenn die Auswahlen Teams sind, PLAYER, wenn es Spieler sind, UNKNOWN, wenn sie keins von beiden sind (ein Trainer, eine Division, ein Bundesstaat).

ZeilenformenPermalink zu diesem Abschnitt

Formselectionselection_linepointsBeispiel-Future
OutrightDas Team, der Spieler oder ein anderes Subjekt: Kansas City Chiefsnullnullnfl__super_bowl_winner
LadderDas Team: Buffalo Billsover oder underDie Linie: 12.5nfl__regular_season_wins
Yes/NoDas Subjekt: Buffalo Billsyes oder nonullnfl__to_make_the_playoffs
PaarZwei Subjekte, verbunden mit ///: Arizona Cardinals /// Baltimore Ravensnullnullnfl__super_bowl_matchup

Ein Paar behält bei einer Exacta (nfl__super_bowl_exacta) die Reihenfolge seiner beiden Namen und listet sie bei einem Matchup alphabetisch.

Yes/No-ZwillingePermalink zu diesem Abschnitt

Viele Outrights haben einen Zwilling-Future mit der ID <id>_yes_no und dem Namen <Name> Yes/No: nfl__super_bowl_winner und nfl__super_bowl_winner_yes_no. Das Outright enthält jeden Preis auf ein Subjekt, ohne Wettseite. Der Zwilling wiederholt jeden dieser Preise als yes-Zeile und fügt den Preis des Sportsbooks gegen das Subjekt, sofern es einen listet, als no-Zeile hinzu. Eine no-Zeile erscheint nie im Outright. Ein Zwilling enthält nur yes-Zeilen, wenn kein Sportsbook einen Preis dagegen listet. Nicht jedes Outright hat einen Zwilling: nba__championship_winner hat keinen.

Der Preis von BetMGM auf die Kansas City Chiefs, im Outright und in seinem Zwilling:

Futurenameselection_lineprice
nfl__super_bowl_winnerKansas City Chiefsnull900
nfl__super_bowl_winner_yes_noKansas City Chiefs Yesyes900

Was nicht geliefert wirdPermalink zu diesem Abschnitt

Das Angebot eines Sportsbooks, das zu keinem Future passt, wird nicht geliefert: wöchentliche Specials, spielbezogene Props, Preis-Boosts und Novelty-Märkte. Ein Sportsbook hat in einem Future höchstens eine Zeile pro Auswahl, Wettseite und Linie.

GET /api/v1/futuresPermalink zu diesem Abschnitt

Ruft die Futures ab: jedes Future mit den Sportsbooks, die es anbieten, und dem Umfang der Preise.

GET /api/v1/futures

Query-ParameterPermalink zu diesem Abschnitt

ParameterTypStandardBeschreibung
sportstringalleFiltern nach Sportart: ein Wert, Groß-/Kleinschreibung egal (football, basketball, soccer)
leaguestringalleFiltern nach Liga: ein Wert, Groß-/Kleinschreibung egal, so wie /leagues ihn listet (nfl, nba, england_-_premier_league)
future_typestringalleTEAM, PLAYER oder UNKNOWN, Groß-/Kleinschreibung egal. Jeder andere Wert liefert ein leeres data.
future_idstringalleEine Future-ID oder mehrere, kommagetrennt

Jedes passende Future wird geliefert: Es gibt keine Paginierung, und sportsbook, limit und offset werden ignoriert, falls sie gesendet werden.

BeispielanfragePermalink zu diesem Abschnitt

curl "https://api.sharpapi.io/api/v1/futures?league=nfl" \ -H "X-API-Key: YOUR_API_KEY"

AntwortPermalink zu diesem Abschnitt

Auf drei Futures gekürzt. meta.count ist die Anzahl der Futures in der vollständigen Antwort.

{ "success": true, "data": [ { "id": "nfl__1st_overall_pick_2027", "name": "1st Overall Pick 2027", "future_type": "PLAYER", "sport": "football", "league": "nfl", "start_date": "2026-11-07T17:05:00Z", "books_available": [ "betmgm", "betonline", "bwin", "fanduel" ], "selection_count": 88, "odds_count": 198 }, { "id": "nfl__afc_conference_winner", "name": "AFC Conference Winner", "future_type": "TEAM", "sport": "football", "league": "nfl", "start_date": "2026-11-06T01:15:00Z", "books_available": [ "betonline", "saba" ], "selection_count": 16, "odds_count": 32 }, { "id": "nfl__afc_conference_winner_yes_no", "name": "AFC Conference Winner Yes/No", "future_type": "TEAM", "sport": "football", "league": "nfl", "start_date": "2026-11-06T01:15:00Z", "books_available": [ "betonline", "saba" ], "selection_count": 16, "odds_count": 32 } ], "meta": { "count": 47, "updated_at": "2026-10-26T12:39:49.784599258Z" } }

Futures sind nach league sortiert, dann nach id. meta.updated_at gibt an, wann die Futures-Daten dieser Antwort gelesen wurden (RFC 3339), nicht wann die Antwort gesendet wurde. Aufeinanderfolgende Anfragen können denselben Wert liefern.

Future-ObjektPermalink zu diesem Abschnitt

FeldTypBeschreibung
idstringDie ID des Futures (nfl__super_bowl_winner). Übergeben Sie sie als future_id an /futures/odds.
namestringDer Name des Futures (Super Bowl Winner). Ein Yes/No-Zwilling endet auf Yes/No.
future_typestringTEAM, PLAYER oder UNKNOWN
sportstringSportart (football)
leaguestringLiga-ID (nfl)
start_datestring | nullDer früheste Start, den ein Sportsbook für dieses Future sendet, in UTC (2027-06-01T19:00:00Z), oder null, wenn keines einen sendet. Sportsbooks datieren einen Futures-Markt nach seinem Schluss oder nach dem Beginn seines Events, daher können sie voneinander abweichen; angezeigt wird der früheste, auch wenn er schon vorbei ist. Das eigene Datum eines Sportsbooks erhalten Sie, wenn Sie /futures/odds nur für dieses Sportsbook abfragen.
books_availablearray of stringDie Sportsbooks, die dieses Future anbieten, nach Namen sortiert
selection_countintegerVerschiedene Auswahlen im Future
odds_countintegerZeilen im Future: jedes Sportsbook, jede Auswahl, Wettseite und Linie

GET /api/v1/futures/oddsPermalink zu diesem Abschnitt

Ruft die Futures mit ihren Quoten ab. Jedes Future enthält eine Zeile pro Sportsbook, Auswahl, Wettseite und Linie.

GET /api/v1/futures/odds

Query-ParameterPermalink zu diesem Abschnitt

ParameterTypStandardBeschreibung
future_idstring-Eine Future-ID oder mehrere, kommagetrennt. Erforderlich, sofern league nicht angegeben ist.
leaguestring-Alle Futures einer Liga: Groß-/Kleinschreibung egal, so wie /leagues sie listet (nfl). Erforderlich, sofern future_id nicht angegeben ist.
sportstringalleFiltern nach Sportart: ein Wert, Groß-/Kleinschreibung egal
future_typestringalleTEAM, PLAYER oder UNKNOWN, Groß-/Kleinschreibung egal. Jeder andere Wert liefert ein leeres data.
sportsbookstringalleNur Zeilen dieser Sportsbooks, kommagetrennt (fanduel,betmgm). books wird als Alias akzeptiert.
team_idstringalleNur Zeilen zu diesen Teams, kommagetrennte Team-IDs (kansas_city_chiefs). Eine Zeile mit team_id null passt nie.
selectionstringalleNur Zeilen zu diesen Auswahlen, kommagetrennte Namen (Boston Celtics). Groß-/Kleinschreibung, Akzente und Satzzeichen werden ignoriert, sodass CJ Stroud auch C.J. Stroud findet. Ein normalized_selection-Wert passt ebenfalls.
is_mainboolean-true: die Hauptlinie jeder Ladder und jede Zeile, die nicht zu einer Ladder gehört. false: nur die übrigen Linien einer Ladder. Jeder andere Wert wird ignoriert.
limitinteger50Futures pro Seite, von 1 bis 200. Ein Wert außerhalb dieses Bereichs (0, negativ, über 200, keine Zahl) wird zu 50.
offsetinteger0Zu überspringende Futures. Ein negativer oder nicht numerischer Wert wird zu 0.

Übergeben Sie future_id oder league. Eine Anfrage mit keinem von beiden liefert 400 validation_error, sodass keine Anfrage jede Zeile jeder Liga abruft. Manche Futures enthalten Hunderte Zeilen (eine Super-Bowl-Exacta listet Hunderte Team-Paare): Grenzen Sie mit sportsbook, team_id, selection oder is_main ein.

BeispielanfragenPermalink zu diesem Abschnitt

# Der Preis eines Teams auf ein Outright, bei jedem Sportsbook curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__super_bowl_winner&team_id=kansas_city_chiefs" \ -H "X-API-Key: YOUR_API_KEY" # Die Win-Total-Ladder eines Teams curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nba__regular_season_wins&selection=Boston+Celtics" \ -H "X-API-Key: YOUR_API_KEY" # Nur die Win-Total-Hauptlinie jedes Sportsbooks, für jedes NFL-Team curl "https://api.sharpapi.io/api/v1/futures/odds?future_id=nfl__regular_season_wins&is_main=true" \ -H "X-API-Key: YOUR_API_KEY" # Alle NBA-Futures eines Sportsbooks, zwei Futures pro Seite, zweite Seite curl "https://api.sharpapi.io/api/v1/futures/odds?league=nba&sportsbook=fanduel&limit=2&offset=2" \ -H "X-API-Key: YOUR_API_KEY"

AntwortPermalink zu diesem Abschnitt

Antwort auf die erste Anfrage. Auf zwei ihrer sechs Zeilen gekürzt; meta.odds_count ist die Anzahl der Zeilen in der vollständigen Antwort.

{ "success": true, "data": [ { "id": "nfl__super_bowl_winner", "name": "Super Bowl Winner", "future_type": "TEAM", "sport": "football", "league": "nfl", "start_date": "2026-09-10T00:20:00Z", "odds": [ { "id": "nfl__super_bowl_winner:betmgm:kansas_city_chiefs", "sportsbook": "betmgm", "market": "Super Bowl Winner", "name": "Kansas City Chiefs", "selection": "Kansas City Chiefs", "normalized_selection": "kansas_city_chiefs", "selection_line": null, "points": null, "is_main": true, "price": 900, "team_id": "kansas_city_chiefs" }, { "id": "nfl__super_bowl_winner:betonline:kansas_city_chiefs", "sportsbook": "betonline", "market": "Super Bowl Winner", "name": "Kansas City Chiefs", "selection": "Kansas City Chiefs", "normalized_selection": "kansas_city_chiefs", "selection_line": null, "points": null, "is_main": true, "price": 850, "team_id": "kansas_city_chiefs" } ] } ], "pagination": { "limit": 50, "offset": 0, "count": 1, "total": 1, "has_more": false, "next_offset": null }, "meta": { "count": 1, "total": 1, "odds_count": 6, "updated_at": "2026-10-26T12:39:49.784599258Z" } }

Antwort auf die zweite Anfrage, eine Ladder. Auf vier ihrer zehn Zeilen gekürzt: BetMGM bepreist eine Linie, 51.5, auf beiden Seiten, und FanDuel listet nur Overs, bei sechs Linien.

{ "success": true, "data": [ { "id": "nba__regular_season_wins", "name": "Regular Season Wins", "future_type": "TEAM", "sport": "basketball", "league": "nba", "start_date": "2027-06-19T00:40:00Z", "odds": [ { "id": "nba__regular_season_wins:betmgm:boston_celtics:over:51.5", "sportsbook": "betmgm", "market": "Regular Season Wins", "name": "Boston Celtics Over 51.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "over", "points": 51.5, "is_main": true, "price": -145, "team_id": "boston_celtics" }, { "id": "nba__regular_season_wins:betmgm:boston_celtics:under:51.5", "sportsbook": "betmgm", "market": "Regular Season Wins", "name": "Boston Celtics Under 51.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "under", "points": 51.5, "is_main": true, "price": 120, "team_id": "boston_celtics" }, { "id": "nba__regular_season_wins:fanduel:boston_celtics:over:49.5", "sportsbook": "fanduel", "market": "Regular Season Wins", "name": "Boston Celtics Over 49.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "over", "points": 49.5, "is_main": false, "price": -220, "team_id": "boston_celtics" }, { "id": "nba__regular_season_wins:fanduel:boston_celtics:over:54.5", "sportsbook": "fanduel", "market": "Regular Season Wins", "name": "Boston Celtics Over 54.5", "selection": "Boston Celtics", "normalized_selection": "boston_celtics", "selection_line": "over", "points": 54.5, "is_main": true, "price": 130, "team_id": "boston_celtics" } ] } ], "pagination": { "limit": 50, "offset": 0, "count": 1, "total": 1, "has_more": false, "next_offset": null }, "meta": { "count": 1, "total": 1, "odds_count": 10, "updated_at": "2026-10-26T12:41:24.754966665Z" } }

ZeilenobjektPermalink zu diesem Abschnitt

Jedes Future in data enthält die id, name, future_type, sport und league, die /futures listet, ein start_date sowie ein odds-Array mit Zeilen. Ein Future, bei dem nach den Filtern keine Zeile übrig bleibt, entfällt.

Hier ist start_date der früheste Start unter den Sportsbooks, die die Anfrage mit sportsbook nennt (alle, wenn sie keines nennt), oder null, wenn keines davon einen sendet. Eine Anfrage für ein einzelnes Sportsbook liefert also dessen eigenes Datum. team_id, selection und is_main filtern Zeilen und lassen start_date unverändert.

FeldTypBeschreibung
idstringDie ID der Zeile: die Future-ID, das Sportsbook und die normalized_selection, dann Wettseite und Punkte, sofern die Zeile sie hat, verbunden mit : (nfl__regular_season_wins:betmgm:buffalo_bills:over:12.5). Sie ändert sich nicht, wenn sich der Preis ändert.
sportsbookstringSportsbook-ID (betmgm)
marketstringDer name des Futures, in jeder Zeile wiederholt
namestringEine Anzeigebezeichnung: die Auswahl, dann die Wettseite mit großem Anfangsbuchstaben, dann die Punkte (Kansas City Chiefs, Kansas City Chiefs Yes, Buffalo Bills Over 12.5)
selectionstringDer kanonische Name des Teams oder Spielers, für jedes Sportsbook gleich (San Francisco 49ers). Ein Paar sind zwei Namen, verbunden mit ///.
normalized_selectionstringselection in Kleinbuchstaben, wobei jede Folge von Zeichen außer a-z, Ziffern und - durch ein _ ersetzt wird: C.J. Stroud wird zu c_j_stroud, Jaren Jackson Jr. zu jaren_jackson_jr_. Verknüpfen Sie Zeilen über Sportsbooks hinweg damit.
selection_linestring | nullover oder under bei einer Ladder, yes oder no bei einem Yes/No-Future, null bei einem Outright oder einem Paar
pointsnumber | nullDie Linie einer Ladder (12.5). null bei jeder Zeile, deren selection_line weder over noch under ist.
is_mainbooleantrue bei der Hauptlinie eines Sportsbooks in einer Ladder, false bei seinen übrigen Linien. Immer true bei einer Zeile, die nicht zu einer Ladder gehört. Siehe unten.
priceintegerAmerikanische Quote: 900 ist +900, -130 ist -130. Leiten Sie daraus Dezimalquote und implizite Wahrscheinlichkeit ab: siehe Quotenformate.
team_idstring | nullDie ID des Teams, dieselbe ID, die die Quoten-Endpunkte für Teams verwenden (Entitäts-Referenz-IDs), wenn die Auswahl ein Team ist. Sonst null: ein Spieler, ein Paar, ein Trainer, eine Division, ein Bundesstaat oder ein Team, das SharpAPI nicht zuordnen kann. Sie ist nicht immer gleich normalized_selection: Arsenal FC ist arsenal.

HauptlinienPermalink zu diesem Abschnitt

Ein Sportsbook kann für dieselbe Auswahl mehrere Linien einer Ladder listen. is_main ist pro Sportsbook und Auswahl bei genau einer Linie true: der Linie, die das Sportsbook auf beiden Seiten bepreist und deren beide Preise am nächsten an einer ausgeglichenen Quote liegen. Bepreist es keine Linie auf beiden Seiten, wie FanDuel oben, ist es die Linie, deren Preis einer ausgeglichenen Quote am nächsten liegt, hier 54.5 bei +130. Eine auf beiden Seiten bepreiste Linie gewinnt immer gegen eine auf einer Seite bepreiste, und bei Gleichstand gewinnt die niedrigere Linie. is_main=true behält diese Linien (und jede Zeile, die nicht zu einer Ladder gehört); is_main=false behält die übrigen.

Sortierung und PaginierungPermalink zu diesem Abschnitt

Futures sind nach league sortiert, dann nach id. Zeilen innerhalb eines Futures sind nach normalized_selection sortiert, dann nach sportsbook, dann nach Wettseite (keine Seite, over, under, yes, no), dann nach points. Zeilen sind nicht nach Preis sortiert: Sortieren Sie clientseitig.

limit und offset zählen Futures, nicht Zeilen. Eine Seite enthält bis zu limit Futures, jedes mit allen seinen Zeilen, die zu den Filtern passen.

FeldTypBeschreibung
pagination.limitintegerFutures pro Seite, wie angewendet
pagination.offsetintegerVor dieser Seite übersprungene Futures
pagination.countintegerFutures auf dieser Seite. Entspricht meta.count.
pagination.totalintegerFutures, die zu den Filtern passen, vor der Paginierung. Entspricht meta.total.
pagination.has_morebooleanOb eine weitere Seite folgt
pagination.next_offsetinteger | nullDer offset der nächsten Seite, oder null auf der letzten Seite
meta.countintegerFutures in data
meta.totalintegerFutures, die zu den Filtern passen, vor der Paginierung
meta.odds_countintegerZeilen in data, über alle Futures hinweg
meta.updated_atstringWann die Futures-Daten dieser Antwort gelesen wurden (RFC 3339), nicht wann die Antwort gesendet wurde. Aufeinanderfolgende Anfragen können denselben Wert liefern.

Der Umschlag der vierten Anfrage, die zweite Seite der NBA-Futures bei zwei pro Seite. 19 Futures passen; die beiden auf dieser Seite enthalten 13 und 15 Zeilen, also ist meta.odds_count 28.

{ "success": true, "data": [ ... ], "pagination": { "limit": 2, "offset": 2, "count": 2, "total": 19, "has_more": true, "next_offset": 4 }, "meta": { "count": 2, "total": 19, "odds_count": 28, "updated_at": "2026-10-26T12:41:24.754966665Z" } }

FehlerPermalink zu diesem Abschnitt

StatusCodeWann
400validation_error/futures/odds wurde weder mit future_id noch mit league aufgerufen
401missing_api_key, invalid_api_keyKein API key oder ein ungültiger
403tier_restrictedDer Tarif des Keys liegt unter Enterprise
429rate_limitedRate-Limit überschritten
503service_unavailableFutures-Daten sind vorübergehend nicht verfügbar: Es konnte keine Kopie gelesen werden, die jünger als 5 Minuten ist. Versuchen Sie es später erneut; der Header Retry-After nennt die Wartezeit in Sekunden.
{ "error": { "code": "validation_error", "message": "Missing required parameter: future_id or league" } }

Ein Filter, der auf kein Future passt, ist kein Fehler: Die Antwort ist 200 mit leerem data.

Migration von der bisherigen AntwortformPermalink zu diesem Abschnitt

Beide Endpunkte behalten ihre Pfade und liefern die oben beschriebene Form. Die bisherige Form wird nicht mehr ausgeliefert, und kein Parameter bringt sie zurück.

Eine future_id aus der bisherigen Form (championship_winner) passt jetzt auf nichts: Die Antwort ist 200 mit leerem data. Entnehmen Sie die neuen IDs aus GET /api/v1/futures. Auch future_type=OVER_UNDER und future_type=YES_NO liefern ein leeres data: Die Future-Typen sind TEAM, PLAYER und UNKNOWN, und die Wettseite einer Zeile ist ihre selection_line.

GET /api/v1/futures

BisherJetzt
market_id (championship_winner)id (nba__championship_winner): die Werte haben sich geändert
display_name (NBA Championship Winner)name (Championship Winner)
future_type: TEAM, PLAYER, OVER_UNDER, YES_NOfuture_type: TEAM, PLAYER, UNKNOWN
sport, league, selection_count, books_availableBeibehalten
-odds_count
-start_date
-Query-Parameter future_id

GET /api/v1/futures/odds

BisherJetzt
Eine flache Liste von Zeilen, nach Zeilen paginiert, standardmäßig 100 ZeilenEine Liste von Futures mit je einem odds-Array, nach Futures paginiert, standardmäßig 50 Futures
future_id erforderlichfuture_id oder league erforderlich
selectionselection, und normalized_selection für Joins
sportsbooksportsbook
odds_americanprice
odds_decimal, probabilityEntfernt: leiten Sie sie aus price ab
linepoints, mit der Wettseite in selection_line (over, under, yes, no)
future_market_id, future_market_name, future_type, sport, league in jeder Zeileid, name, future_type, sport, league am Future, das die Zeilen enthält
event_start_time in jeder Zeilestart_date am Future, das die Zeilen enthält: der früheste Start unter den abgefragten Sportsbooks
meta.future_id, meta.books_count, meta.selections_countEntfernt
-id, market, name, is_main, team_id in jeder Zeile
-Query-Parameter future_type, team_id, selection, is_main

Verwandte SeitenPermalink zu diesem Abschnitt

  • MCP-Server (KI-Assistenten) - die Tools get_futures, get_futures_odds und compare_futures_lines lesen diese Endpunkte
  • Ligen - die Liga-IDs, die Sie als league übergeben
  • Quotenformate - amerikanisch, dezimal und implizite Wahrscheinlichkeit
Last updated on