Beste Quoten
Erhalten Sie die besten verfügbaren Quoten für jede Auswahl über alle Sportwettenanbieter hinweg. Dieser Endpoint vergleicht Quoten von jedem Buch, das in Ihrem Tarif verfügbar ist, und gibt die günstigste Linie für jede Auswahl zurück, zusammen mit Vergleichen pro Buch und Edge-Berechnungen.
GET /api/v1/odds/bestAuthentifizierungPermalink zu diesem Abschnitt
Erfordert API-Schlüssel. Verfügbar für alle Tarife.
Best Odds ist in allen Tarifen verfügbar, einschließlich Free. Die verglichenen Sportwettenanbieter hängen vom Buchzugriff Ihres Tarifs ab (Free vergleicht DraftKings und FanDuel; Sharp+ schließt Pinnacle ein).
Query-ParameterPermalink zu diesem Abschnitt
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
sport | string | alle | Filter nach Sportart(en), kommagetrennt (z. B. basketball, football). Nur Sport-IDs; eine Liga-ID wie nba gehört in league (Details). |
league | string | alle | Filter nach Liga(en), kommagetrennt (z. B. nba, nfl) |
market | string | alle | Filter nach Markttyp(en), kommagetrennt (z. B. moneyline, spread, total). Unterstützt Kategorie-Aliase — siehe Odds: Marktkategorie-Aliase. |
event_id | string | — | Filter nach Event-ID(s), kommagetrennt |
is_live | boolean | — | true = nur live, false = nur prematch, weglassen = beides |
min_odds | number | — | Filter für minimale American Odds |
max_odds | number | — | Filter für maximale American Odds |
limit | integer | 50 | Maximale Ergebnisse pro Seite (max. 200) |
offset | integer | 0 | Paginierungs-Offset |
Veraltete Quoten (älter als 5 Minuten für Pre-Game, 1 Minute für Live) werden automatisch von Best-Odds-Vergleichen ausgeschlossen, um irreführende Ergebnisse zu vermeiden.
is_main_line vs. market=main. is_main_line wird pro (event, market_type, Auswahlachse)-Kohorte ausgewertet und je Buchmacher aufgelöst; die Auswahlachse ist der Spieler bei Player Props, die Teamseite bei Spread- und Team-Total-Märkten und ansonsten die rohe selection. Markiert wird nach bestem Bemühen die Hauptlinie innerhalb der eigenen Linienstaffel jedes Markts. Perioden- und Prop-Märkte liefern daher zu Recht Zeilen mit is_main_line=true (z. B. die Haupt-Halbzeit-Gesamtlinie oder die Hauptlinie je Spieler in einem Player-Prop-Markt). In einem Markt sind normalerweise mehrere Zeilen gleichzeitig Hauptlinie – eine je Auswahlachse: Over und Under einer Gesamtlinie sind getrennte Kohorten, ebenso jedes Ergebnis eines Kombinationsmarkts (z. B. Spielergebnis + Gesamttore). ?is_main_line=true ist somit kein Filter, der nur die Hauptlinien des gesamten Spiels liefert, und auch keine Eindeutigkeitsgarantie. Um die Ergebnisse auf die Hauptlinien des gesamten Spiels zu beschränken (Moneyline, Spiel-Handicap, Spiel-Gesamtlinie), verwende stattdessen den Kategorie-Alias ?market=main, optional kombiniert mit ?is_main_line=true, um zusätzlich die Alt-Linien innerhalb dieser Märkte auszuschließen.
BeispielanfragenPermalink zu diesem Abschnitt
cURL
curl -X GET "https://api.sharpapi.io/api/v1/odds/best?league=nba&market=spread" \
-H "X-API-Key: YOUR_API_KEY"AntwortPermalink zu diesem Abschnitt
Erfolg (200)Permalink zu diesem Abschnitt
{
"success": true,
"data": [
{
"event_id": "evt_nba_lal_bos_20260126",
"event_name": "Los Angeles Lakers @ Boston Celtics",
"sport": "basketball",
"league": "nba",
"market_type": "spread",
"selection": "Boston Celtics",
"line": -6.5,
"best_odds": {
"american": -105,
"decimal": 1.952,
"odds_probability": 0.512
},
"best_book": "fanduel",
"all_books": [
{
"book": "fanduel",
"odds": { "american": -105, "decimal": 1.952 },
"edge": 0.007,
"line": -6.5
},
{
"book": "draftkings",
"odds": { "american": -110, "decimal": 1.909 },
"edge": 0.0,
"line": -6.5
},
{
"book": "betmgm",
"odds": { "american": -108, "decimal": 1.926 },
"edge": 0.003,
"line": -6.5
},
{
"book": "pinnacle",
"odds": { "american": -108, "decimal": 1.926 },
"edge": 0.003,
"line": -6.5
}
],
"timestamp": "2026-01-26T10:30:00.000Z",
"price_updated_at": "2026-01-26T10:14:52.000Z"
}
],
"meta": {
"count": 1,
"total": 48,
"pagination": {
"limit": 50,
"offset": 0,
"has_more": false,
"next_offset": null
},
"updated_at": "2026-01-26T10:30:05.000Z",
"filters": {
"league": "nba",
"market": "spread"
}
}
}Antwort-HeaderPermalink zu diesem Abschnitt
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 298
X-RateLimit-Reset: 1737853200
X-Data-Delay: 0
X-Request-Id: req_best_789xyzFehlerantwortenPermalink zu diesem Abschnitt
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. Retry after 30 seconds.",
"docs": "https://docs.sharpapi.io/en/authentication#rate-limits"
}
}Schema des Best-Odds-ObjektsPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
event_id | string | Event-Kennung |
event_name | string | Anzeigename des Events (z. B. „Lakers @ Celtics”) |
sport | string | Sportart-Slug |
league | string | Liga-Slug |
market_type | string | Markttyp (z. B. moneyline, spread, total) |
selection | string | Name der Auswahl (Teamname, Over/Under) |
line | number | null | Linienwert (für Spreads/Totals) |
best_odds | object | Beste verfügbare Quoten über alle Bücher hinweg |
best_odds.american | number | Beste American Odds |
best_odds.decimal | number | Beste Dezimalquoten |
best_odds.probability | number | Implizite Wahrscheinlichkeit der besten Quoten |
best_book | string | Sportwettenanbieter-ID mit den besten Quoten |
all_books | array | Quoten aller Sportwettenanbieter für diese Auswahl |
all_books[].book | string | Sportwettenanbieter-ID |
all_books[].odds | object | Odds-Objekt (american, decimal) |
all_books[].edge | number | Edge gegenüber den schlechtesten verfügbaren Quoten (Prozentpunkte) |
all_books[].line | number | null | Linie bei diesem Sportwettenanbieter |
timestamp | string | ISO-8601-Zeitstempel der Best-Odds-Bestimmung |
price_updated_at | string|undefined | ISO-8601-Zeitpunkt, zu dem der beste Preis (der des in best_book genannten Buchmachers) zuletzt aktualisiert wurde, nicht die jüngste Zeit über alle Buchmacher. Er rückt vor, wenn sich dieser Preis, seine Linie, Live-Status, Aussetzung, Orderbuch oder verfügbare Größe ändern. Fehlt, wenn keine Änderungszeit vorliegt. Siehe timestamp verstehen. |
player_name | string|undefined | Spielername (nur bei Player-Prop-Märkten) |
stat_category | string|undefined | Statistik-Kategorie, z. B. points, rebounds (nur bei Player-Prop-Märkten) |
Pinnacle wird üblicherweise als Sharp-Referenz verwendet. Wenn Pinnacle in all_books verfügbar ist, können Sie es anhand von book: "pinnacle" identifizieren und seine Quoten mit Soft Books vergleichen, um +EV-Gelegenheiten zu finden.
Warum beste Quoten wichtig sindPermalink zu diesem Abschnitt
Die besten verfügbaren Quoten zu finden, ist die Grundlage für profitables Sportwetten:
1. Line Shopping spart GeldPermalink zu diesem Abschnitt
Der Unterschied zwischen -105 und -110 mag klein erscheinen, aber er summiert sich im Laufe der Zeit dramatisch:
| Quoten | Gewinn bei $100-Einsatz | Break-Even-Gewinnrate |
|---|---|---|
| -115 | +$87 | 53,5 % |
| -110 | +$91 | 52,4 % |
| -105 | +$95 | 51,2 % |
| +100 | +$100 | 50,0 % |
2. Langfristige AuswirkungenPermalink zu diesem Abschnitt
Über 1.000 Wetten bei einer Gewinnrate von 52 %:
| Konsistente Quoten | Nettoergebnis |
|---|---|
| -115 | -$44 Verlust |
| -110 | +$18 Gewinn |
| -105 | +$80 Gewinn |
3. Edge-VergleichPermalink zu diesem Abschnitt
Das edge-Feld jedes Buches in all_books zeigt, wie viel besser (oder schlechter) die Quoten dieses Buches im Vergleich zur schlechtesten verfügbaren Linie sind, und hilft Ihnen, den Wert des Vergleichs über mehrere Bücher hinweg zu quantifizieren.
Verwandte EndpointsPermalink zu diesem Abschnitt
- Odds Snapshot - Erhalten Sie Rohquoten von einzelnen Sportwettenanbietern
- Odds Delta - Erhalten Sie nur Quoten, die sich seit einem bestimmten Zeitstempel geändert haben
- Odds Comparison - Vergleichen Sie Quoten Seite an Seite über mehrere Bücher hinweg
- Sportsbooks - Sehen Sie, welche Bücher verfügbar sind und welchen Status sie haben