Märkte
Ruft verfügbare Markttypen, ihre Konfigurationen und Sportverfügbarkeit ab.
GET /api/v1/marketsErfordert einen API-Schlüssel. Verfügbar in allen Tarifen (Free inklusive). Nicht authentifizierte Anfragen geben 401 zurück.
Query-ParameterPermalink zu diesem Abschnitt
Alle Parameter sind optional. Ohne Parameter listet die Antwort jeden Markt, der eine aktuelle Quote hat. catalog=true listet jeden Markt, mit oder ohne Quote.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
sport | string | — | Nur Märkte, die in diesen Sportarten bepreist sind; mehrere kommagetrennt (basketball,hockey). event_count, sportsbooks und sports beziehen sich dann nur auf die angefragten Sportarten. |
league | string | — | Nur Märkte, die in diesen Ligen bepreist sind; mehrere kommagetrennt. Verwenden Sie die id aus Ligen. Ein Event, das zwei angefragte Ligen gemeinsam haben, zählt einmal. |
markets_only | boolean | true | false ergänzt jede Zeile um coverage: die Sportsbooks, die den Markt in jeder Sportart und Liga bepreisen. Ein Wert, der kein Boolean ist, ergibt 400 mit dem Code validation_error. |
catalog | boolean | false | true listet jeden Markt der Marktliste, mit oder ohne Quote, und ergänzt jede Zeile um priced. Siehe Katalogansicht. Ein Wert, der kein Boolean ist, ergibt 400 mit dem Code validation_error. |
Mehrere Werte in sport oder league liefern die Vereinigungsmenge, und mit beiden Parametern muss ein Markt beide erfüllen. Eine eingeschränkte Antwort gibt die angewandten Werte sport und league zurück. Ein Wert, für den gerade keine Quoten live sind (oder den wir nicht veröffentlichen), ist kein Fehler: Die Antwort enthält die Zeilen für die übrigen Werte oder data: [] sowie eine filter_warning, die ihn nennt:
{
"data": [],
"filter_warning": {
"code": "unknown_league",
"message": "no odds are live for these leagues right now, or the ids are not ones we publish; see GET /api/v1/leagues for the current list",
"unknown_leagues": ["xyz"]
},
"league": "xyz",
"updated_at": "2026-11-09T16:40:45.488543236Z"
}Bei einer Sportart lautet der Code unknown_sport und die Liste unknown_sports.
BeispielanfragenPermalink zu diesem Abschnitt
cURL
# List all markets
curl -X GET "https://api.sharpapi.io/api/v1/markets" \
-H "X-API-Key: YOUR_API_KEY"
# Nur NBA-Märkte, mit den Sportsbooks jeder Liga
curl -X GET "https://api.sharpapi.io/api/v1/markets?league=nba&markets_only=false" \
-H "X-API-Key: YOUR_API_KEY"
# Jeder Markt, mit oder ohne Quote
curl -X GET "https://api.sharpapi.io/api/v1/markets?catalog=true" \
-H "X-API-Key: YOUR_API_KEY"AntwortPermalink zu diesem Abschnitt
Erfolg (200)Permalink zu diesem Abschnitt
Echte Antwort, gekürzt auf zwei der derzeit zurückgegebenen Markttypen (absteigend nach event_count sortiert):
{
"data": [
{
"id": "moneyline",
"name": "Moneyline",
"numerical_id": 878,
"event_count": 6910,
"sports": ["aussie_rules", "badminton", "baseball", "basketball", "boxing", "cricket", "darts", "esports", "floorball", "football", "golf", "handball", "hockey", "mma", "rugby_league", "rugby_union", "snooker", "soccer", "table_tennis", "tennis", "volleyball"],
"sportsbooks": ["ballybet", "bet365", "betfair", "betfair_lay", "betfred", "betmgm", "betonline", "betparx", "betrivers", "betsson", "betvictor", "betway", "bovada", "bwin", "caesars", "circa", "codere", "coral", "draftkings", "eighteenbet", "fanatics", "fanatics_markets", "fanduel", "fliff", "gemini", "ggbet", "goldrush", "hardrock", "kalshi", "ladbrokes", "ladbrokes_uk", "matchbook", "novig", "onexbet", "paddypower", "pinnacle", "polymarket", "prophetx", "rebet", "robinhood", "saba", "sbobet", "skybet", "smarkets", "sport888_it", "sportzino", "stake", "sx_bet", "thescorebet", "thrillzz", "unibet"]
},
{
"id": "2nd_half_team_total",
"name": "2nd Half Team Total",
"numerical_id": 331,
"event_count": 42,
"sports": ["basketball", "football"],
"sportsbooks": ["draftkings", "fanduel", "hardrock"]
}
],
"updated_at": "2026-11-09T16:44:28.388212051Z"
}Schema des Markt-ObjektsPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Markt-Slug — genau der Wert, den die Quoten-Endpunkte als market_type= (oder dessen Alias market=) akzeptieren. Siehe den Abschnitt zur Verwendung von Märkten in Filtern weiter unten. |
name | string | Lesbare Bezeichnung, nur zur Anzeige: die Bezeichnung aus der Marktliste, oder für einen Markt, den die Liste noch nicht enthält, ein aus id gebildeter Name. Siehe Namen. Kein Filterwert — verwenden Sie stattdessen id. |
numerical_id | integer | Stabiler Integer-Schlüssel (eingefroren, wird nie wiederverwendet; bei nicht zugeordneten Märkten weggelassen). Neu (Mai 2026) — additiv, optional. Siehe Entitäts-Referenz-IDs. |
event_count | integer | Anzahl unterschiedlicher Events mit mindestens einer aktuellen Quote in diesem Markt, über alle Sportsbooks hinweg, im Umfang von sport / league der Anfrage. Ein Event zählt einmal, egal wie viele Sportsbooks, Linien und Auswahlen es bepreisen. |
sports | string[] | Sport-IDs, die diesen Markt aktuell haben (mit sport= nur die angefragten Sportarten) |
sportsbooks | string[] | Sportsbook-IDs mit mindestens einer aktuellen Quote in diesem Markt, im Umfang der Anfrage, sortiert. Nie null. |
coverage | object[] | Nur mit markets_only=false. Siehe coverage. |
priced | boolean | Nur mit catalog=true. true, wenn mindestens ein Sportsbook im Umfang der Anfrage eine aktuelle Quote in diesem Markt hat. Siehe Katalogansicht. |
coveragePermalink zu diesem Abschnitt
Mit markets_only=false enthält jede Zeile zusätzlich coverage: die Sportarten, in denen der Markt bepreist ist, die Ligen jeder Sportart und die Sportsbooks, die ihn in jeder Liga bepreisen. Sportarten und Ligen sind nach id sortiert, und eine Liga-id ist die, die Ligen zurückgibt. Bei einer eingeschränkten Anfrage enthält coverage nur die angefragten Sportarten und Ligen. Echte Zeile aus ?markets_only=false:
{
"id": "2nd_half_team_total",
"name": "2nd Half Team Total",
"numerical_id": 331,
"event_count": 42,
"sports": ["basketball", "football"],
"sportsbooks": ["draftkings", "fanduel", "hardrock"],
"coverage": [
{
"id": "basketball",
"leagues": [
{ "id": "nba", "sportsbooks": ["draftkings"] },
{ "id": "ncaab", "sportsbooks": ["fanduel"] }
]
},
{
"id": "football",
"leagues": [
{ "id": "nfl", "sportsbooks": ["draftkings", "fanduel", "hardrock"] }
]
}
]
}Eine Quote auf ein Event, dessen Liga wir nicht zuordnen können, fügt ihr Sportsbook trotzdem zu sportsbooks der Zeile hinzu, steht in coverage aber unter keiner Liga. Ein Sportsbook kann also in sportsbooks stehen, ohne in einer Liga aufzutauchen, und coverage ist [] (nie null) für einen Markt, der nur auf solchen Events bepreist ist.
Katalogansicht (catalog=true)Permalink zu diesem Abschnitt
Ohne catalog listet die Antwort nur die Märkte mit einer aktuellen Quote; ein Markt, den gerade kein Sportsbook bepreist, fehlt. catalog=true listet jeden Markt der Marktliste, mit oder ohne Quote: 1.532 Zeilen am 2026-11-11, gegenüber 673 ohne den Parameter. Jede Zeile enthält dann priced:
priced: true: mindestens ein Sportsbook hat eine aktuelle Quote in dem Markt. Die Zeile ist dieselbe wie ohne den Parameter.priced: false: gerade bepreist kein Sportsbook den Markt.event_countist0,sportsundsportsbookssind[](nie null), und mitmarkets_only=falseistcoverage[].
Ein bepreister Markt, den die Marktliste noch nicht enthält, wird trotzdem zurückgegeben, mit priced: true und ohne numerical_id. Die Katalogansicht enthält also immer jede Zeile der Antwort ohne den Parameter. Die Zeilen behalten die übliche Reihenfolge, absteigend nach event_count, daher stehen die Märkte ohne Quote am Ende, nach id sortiert. Echte Zeile ohne Quote aus ?catalog=true:
{
"id": "4th_map_team_total_kills",
"name": "4th Map Team Total Kills",
"numerical_id": 601,
"event_count": 0,
"sports": [],
"sportsbooks": [],
"priced": false
}Die Marktliste sagt nicht, zu welchen Sportarten oder Ligen ein Markt gehört. Mit sport oder league liefert catalog=true daher nur die bepreisten Zeilen dieses Umfangs (dieselben Zeilen wie ohne den Parameter, jede mit priced: true) und lässt die Märkte ohne Quote weg. Ohne den Parameter oder mit catalog=false listet die Antwort wie bisher nur die bepreisten Märkte, und ihre Zeilen haben kein Feld priced.
Geändert (November 2026): Namen stammen aus der MarktlistePermalink zu diesem Abschnitt
Seit dem 2026-11-11 ist der name eines Markts die Bezeichnung, die ihm die Marktliste gibt. Vorher wurden die meisten Namen aus der id gebildet, jedes Wort großgeschrieben. 93 der Märkte mit Quote an diesem Tag änderten einmalig ihren Namen; id, numerical_id und alle Zählwerte sind unverändert. Beispiele:
id | Vorher | Jetzt |
|---|---|---|
defensive_poy | Defensive Poy | Defensive Player of the Year |
halftime_fulltime | Halftime Fulltime | Halftime / Fulltime |
1st_half_total_goals_odd_even | 1st Half Total Goals Odd Even | 1st Half Total Goals Odd/Even |
binary | Binary | Binary (Prediction Market) |
Ein Markt, den die Liste noch nicht enthält, behält den aus seiner id gebildeten Namen. Denselben Namen senden Event-Märkte und Batch-Quoten als market_label, sodass ein Markt auf jedem Endpunkt einen Namen hat. Wenn Sie Märkte über name zuordnen, verwenden Sie stattdessen id.
Geändert (November 2026): event_count zählt EventsPermalink zu diesem Abschnitt
Vor dem 2026-11-09 zählte event_count Quoten (jede Linie und Auswahl bei jedem Sportsbook), nicht Events. Jetzt zählt jedes Event einmal, daher sind die Werte stark gesunken: Über den gesamten Katalog fiel point_spread von rund 110.000 auf rund 3.100. Wenn Sie Märkte nach event_count sortieren oder filtern, prüfen Sie Ihre Schwellenwerte. Mit derselben Änderung kamen sportsbooks und markets_only=false hinzu.
MarkttypenPermalink zu diesem Abschnitt
Die folgenden Tabellen sind eine beschreibende Marktreferenz. Die Spalte Hat Linie beschreibt den Markttyp und ist kein Feld der /markets-Antwort (die Antwortfelder stehen in der Schema-Tabelle oben).
KernmärktePermalink zu diesem Abschnitt
Die beliebtesten und am häufigsten verfügbaren Wettmärkte.
| Markt | Beschreibung | Hat Linie | Beispiele |
|---|---|---|---|
moneyline | Sieger direkt tippen | Nein | Lakers -150, Celtics +130 |
point_spread | Punktespread / Handicap-Wette | Ja | Lakers -4.5 (-110), Celtics +4.5 (-110) |
total_points | Über/Unter kombinierter Punktestand | Ja | Over 220.5 (-110), Under 220.5 (-110) |
team_total | Wette auf den Punktestand eines Teams | Ja | Lakers Over 112.5, Lakers Under 112.5 |
Prop-MärktePermalink zu diesem Abschnitt
Spieler- und Spiel-Propositionswetten für spezifischere Ergebnisse.
| Markt | Beschreibung | Hat Linie | Beispiele |
|---|---|---|---|
player_prop | Statistiken einzelner Spieler (Punkte, Rebounds, Assists usw.) | Ja | LeBron James Over 25.5 Points |
game_prop | Spielspezifische Ergebnisse (z. B. Verlängerung) | Nein | First Team to Score |
PeriodenmärktePermalink zu diesem Abschnitt
Märkte für bestimmte Perioden innerhalb eines Spiels (Halbzeiten, Viertel).
| Markt | Beschreibung | Hat Linie |
|---|---|---|
1st_half | Moneyline, Spread oder Total der 1. Halbzeit | Ja |
1st_quarter | Moneyline, Spread oder Total des 1. Viertels | Ja |
Weitere MärktePermalink zu diesem Abschnitt
| Markt | Beschreibung | Hat Linie | Beispiele |
|---|---|---|---|
future | Langfristige Wetten auf Saisonergebnisse oder Meisterschaften | Nein | NBA Championship Winner, MVP Award Winner |
AuswahltypenPermalink zu diesem Abschnitt
| Typ | Verwendet in | Beschreibung |
|---|---|---|
home | Moneyline, Spread, Periode | Heimmannschaft gewinnt oder deckt |
away | Moneyline, Spread, Periode | Auswärtsmannschaft gewinnt oder deckt |
over | Total, Props, Periode | Über dem Linienwert |
under | Total, Props, Periode | Unter dem Linienwert |
yes | Game Props, Team Props | Ergebnis tritt ein |
no | Game Props, Team Props | Ergebnis tritt nicht ein |
Marktverfügbarkeit nach SportartPermalink zu diesem Abschnitt
| Sportart | Moneyline | Spread | Total | Player Props | Team Props | Periode |
|---|---|---|---|---|---|---|
| Basketball (NBA) | Ja | Ja | Ja | Ja | Ja | Ja |
| Football (NFL) | Ja | Ja | Ja | Ja | Ja | Ja |
| Baseball (MLB) | Ja | Ja | Ja | Ja | Ja | Ja |
| Hockey (NHL) | Ja | Ja | Ja | Ja | Ja | Ja |
| Basketball (NCAAB) | Ja | Ja | Ja | Eingeschränkt | Eingeschränkt | Ja |
| Football (NCAAF) | Ja | Ja | Ja | Eingeschränkt | Eingeschränkt | Ja |
| Soccer | Ja | Ja | Ja | Eingeschränkt | Eingeschränkt | Eingeschränkt |
| Tennis | Ja | Nein | Ja | Eingeschränkt | Nein | Nein |
| MMA (UFC) | Ja | Nein | Nein | Eingeschränkt | Nein | Nein |
| Golf (PGA) | Ja | Nein | Nein | Eingeschränkt | Nein | Nein |
„Eingeschränkt” bedeutet, dass der Markt für einige Events verfügbar ist, jedoch nicht für alle, je nach Sportsbook und Event. Verwenden Sie die Odds-Endpunkte, um zu sehen, welche Märkte für ein bestimmtes Event verfügbar sind.
Verwendung von Märkten in FilternPermalink zu diesem Abschnitt
Verwenden Sie die Markt-id als Filterparameter für andere Endpunkte. Die Quoten-Endpunkte akzeptieren sie als market_type= oder gleichbedeutend als market=. Das Feld name ist eine Anzeigebezeichnung und kein Filterwert.
# Get only moneyline odds
curl "https://api.sharpapi.io/api/v1/odds?market=moneyline" \
-H "X-API-Key: YOUR_API_KEY"
# Get spread and total odds
curl "https://api.sharpapi.io/api/v1/odds?market=point_spread,total_points" \
-H "X-API-Key: YOUR_API_KEY"
# Get player props only
curl "https://api.sharpapi.io/api/v1/odds?market=player_prop" \
-H "X-API-Key: YOUR_API_KEY"
# Best odds for moneyline markets
curl "https://api.sharpapi.io/api/v1/odds/best?market=moneyline" \
-H "X-API-Key: YOUR_API_KEY"Beispiel: von einer /markets-Zeile zur QuotenabfragePermalink zu diesem Abschnitt
Bei Props unterscheiden sich Anzeigename und Slug am deutlichsten — dort ist die Zuordnung besonders wichtig. Nehmen Sie diese Zeile aus der /markets-Antwort (weitere Felder weggelassen):
{
"id": "player_longest_reception",
"name": "Player Longest Reception",
"sports": ["football"]
}Übergeben Sie die id — player_longest_reception — und nicht den name:
curl "https://api.sharpapi.io/api/v1/odds?market_type=player_longest_reception&league=nfl" \
-H "X-API-Key: YOUR_API_KEY"Jede zurückgegebene Zeile enthält denselben Slug in ihrem eigenen Feld market_type, sodass Sie von einem Ergebnis jederzeit zum passenden /markets-Eintrag zurückfinden.
Linien verstehenPermalink zu diesem Abschnitt
Märkte mit Linie enthalten einen numerischen line-Wert in der Odds-Antwort:
- Spread: Das Punkthandicap (z. B. bedeutet
-6.5, dass das Team mit 7+ Punkten gewinnen muss) - Total: Der Schwellwert für den kombinierten Punktestand (z. B.
215.5für Over/Under) - Player Props: Der Statistikschwellwert (z. B.
24.5Punkte für einen Spieler) - Team Props: Der Team-Statistikschwellwert (z. B.
105.5Team-Gesamtpunkte)
Märkte ohne Linie (wie Moneyline) haben line: null in der Odds-Antwort. Der /markets-Katalog gibt nicht an, welcher Art ein Markt ist; lesen Sie line direkt in den Odds-Zeilen.
Verwandte EndpunktePermalink zu diesem Abschnitt
- Odds-Snapshot - Odds nach Markttyp filtern
- Beste Odds - Beste Odds gefiltert nach Markt
- Sportarten - Verfügbare Sportarten anzeigen
- Sportsbooks - Welche Bookmaker welche Märkte unterstützen