Middles
Findet Middle-Gelegenheiten, bei denen zwei Sportsbooks unterschiedliche Linien anbieten und eine Lücke erzeugen, in der beide Wetten gewinnen können.
GET /api/v1/opportunities/middlesAuthentifizierungPermalink zu diesem Abschnitt
Erfordert einen API-Schlüssel. Pro-Tarif oder höher erforderlich.
Query-ParameterPermalink zu diesem Abschnitt
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
sport | string | alle | Nach Sportart(en) filtern, kommagetrennt (z. B. basketball, football). Nur Sport-IDs; eine Liga-ID wie nba gehört in league (Details). |
league | string | alle | Nach Liga(en) filtern, kommagetrennt (z. B. nba, nfl, nhl) |
sportsbook | string | tarifabhängig | Nach Sportsbook(s) filtern, kommagetrennt. Tarifgrenzen werden durchgesetzt. |
market | string | alle | Nach Markttyp(en) filtern, kommagetrennt (z. B. point_spread, total_points). Unterstützt Kategorie-Aliase — siehe Odds: Markt-Kategorie-Aliase. |
min_size | number | 0.5 | Minimale Middle-Größe in Punkten |
is_live | boolean | — | true = nur live, false = nur Vorspiel, weglassen = beide |
max_odds_age | number | — | Maximales Quotenalter in Sekunden. Filtert veraltete Gelegenheiten heraus. |
sort | string | quality | Sortierfeld: quality (Standard), ev, probability, middle_size, event (Startzeit), market (Markt-ID, natürliche Reihenfolge). Mit - absteigend, mit + aufsteigend (in einer URL als %2B senden: ein einzelnes + wird als Leerzeichen gelesen). Ohne Präfix sind quality, ev, probability und middle_size bestes zuerst, event und market aufsteigend. Bei Gleichstand entscheidet quality (beste zuerst), dann id. Ein unbekannter Wert sortiert nach quality; sein Präfix wird ignoriert. |
limit | integer | 50 | Ergebnisse pro Seite (max. 200) |
offset | integer | 0 | Paginierungs-Offset |
BeispielanfragenPermalink zu diesem Abschnitt
cURL
curl -X GET "https://api.sharpapi.io/api/v1/opportunities/middles?league=nfl&min_size=1" \
-H "X-API-Key: YOUR_API_KEY"AntwortPermalink zu diesem Abschnitt
Erfolg (200)Permalink zu diesem Abschnitt
{
"success": true,
"data": [
{
"id": "a1b2c3d4e5f67890",
"event_id": "evt_nfl_buf_kc_20260217",
"event_name": "Buffalo Bills @ Kansas City Chiefs",
"sport": "football",
"league": "nfl",
"market_type": "point_spread",
"home_team": "Kansas City Chiefs",
"away_team": "Buffalo Bills",
"start_time": "2026-02-17T20:00:00Z",
"side1": {
"book": "draftkings",
"selection": "Kansas City Chiefs",
"selection_type": null,
"line": -2.5,
"odds_american": -110, "odds_decimal": 1.909, "odds_probability": 0.524, "fair_probability": 0.524,
"stake_percent": 50.12,
"odds_age_seconds": 5.0,
"deep_link": "https://api.sharpapi.io/api/v1/deeplink/206720022460212?state=pa"
},
"side2": {
"book": "fanduel",
"selection": "Buffalo Bills",
"selection_type": null,
"line": 7.5,
"odds_american": -108, "odds_decimal": 1.926, "odds_probability": 0.519, "fair_probability": 0.519,
"stake_percent": 49.88,
"odds_age_seconds": 12.3,
"deep_link": null
},
"middle_size": 5.0,
"middle_numbers": [3, 4, 5, 6, 7],
"middle_probability": 0.377,
"expected_value": 31.52,
"roi_percentage": 31.52,
"worst_case_loss": -4.13,
"best_case_profit": 83.54,
"break_even_percent": 4.71,
"odds_age_seconds": 12.3,
"is_guaranteed_profit": false,
"guaranteed_roi": null,
"key_numbers": [3, 7],
"key_number_probability": 0.242,
"is_live": false,
"is_player_prop": false,
"player_name": null,
"stat_category": null,
"warnings": ["HIGH_PROBABILITY", "LARGE_GAP"],
"detected_at": "2026-02-17T19:45:30Z"
}
],
"meta": {
"count": 1,
"total": 47,
"source": "cache",
"pagination": {
"limit": 50,
"offset": 0,
"has_more": false,
"next_offset": null
},
"summary": { "count": 47 },
"filters": {
"sport": null,
"league": ["nfl"],
"sportsbook": null,
"market": null,
"min_size": 1
},
"updated_at": "2026-02-17T19:45:30Z"
}
}Antwort-HeaderPermalink zu diesem Abschnitt
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 296
X-RateLimit-Reset: 1707401000
X-Data-Delay: 0
X-Request-Id: req_mid456abc789FehlerantwortenPermalink 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"
}
}403 Tier Required
{
"error": {
"code": "tier_restricted",
"message": "This endpoint requires Pro tier or higher. Upgrade to Pro for $229/mo: https://sharpapi.io/dashboard/billing/upgrade/pro",
"docs": "https://sharpapi.io/pricing",
"tier": "hobby",
"required_tier": "pro",
"upgrade": "https://sharpapi.io/dashboard/billing/upgrade/pro",
"upgrade_note": "Upgrade to Pro for $229/mo"
}
}AntwortfelderPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Eindeutiger Middle-Identifikator (Hash) |
event_id | string | Ereignis-Identifikator |
event_name | string | Menschenlesbarer Ereignisname |
sport | string | Sportart-Identifikator |
league | string | Liga-Identifikator |
market_type | string | Markttyp (point_spread, total_points, Spielerwetten-Typen) |
home_team | string | Name des Heimteams |
away_team | string | Name des Auswärtsteams |
start_time | string|null | Spielbeginn (ISO 8601) |
side1 | object | Erste Seite der Middle-Wette |
side2 | object | Zweite Seite der Middle-Wette |
middle_size | number | Größe der Middle-Lücke in Punkten |
middle_numbers | number[] | Ganzzahlige Werte, die das Middle treffen würden |
middle_probability | number | Geschätzte Wahrscheinlichkeit, dass das Middle eintritt (sportartspezifisch) |
expected_value | number | EV in Dollar pro $100 Gesamteinsatz |
roi_percentage | number | EV als Prozentsatz des Gesamteinsatzes |
worst_case_loss | number | Verlust bei verfehltem Middle (negativ = Verlust) |
best_case_profit | number | Gewinn bei eingetretenem Middle (beide Wetten gewinnen) |
break_even_percent | number | Mindesttrefferquote zum Break-even |
odds_age_seconds | number|null | Alter der ältesten zugrunde liegenden Quote zum Erkennungszeitpunkt |
is_guaranteed_profit | boolean | True, wenn worst_case_loss >= 0 (Arb + Middle) |
guaranteed_roi | number|null | Worst-Case-ROI% bei Garantie (sonst null) |
key_numbers | number[] | Schlüsselzahlen im Middle-Bereich (z. B. NFL 3, 7) |
key_number_probability | number | Kombinierte Wahrscheinlichkeit nur der Schlüsselzahlen |
quality_score | number | Mehrfaktorielle Qualitätsmetrik (0-100) |
market_overround | number | Kombinierte implizite Wahrscheinlichkeit über beide Seiten |
is_live | boolean | Ob das Spiel live ist: true, wenn unser Spiel-Tracking zeigt, dass das Spiel läuft, oder andernfalls, wenn die Sportsbooks, die das Spiel anbieten, Live-Preise darauf haben. |
is_player_prop | boolean | Ob es sich um ein Spielerwetten-Middle handelt |
player_name | string|null | Spielername (bei Spielerwette) |
stat_category | string|null | Statistiktyp (bei Spielerwette, z. B. points, rebounds) |
warnings | string[] | Warn-Flags (siehe unten) |
detected_at | string | Wann das Middle erkannt wurde (ISO 8601) |
Side-ObjektPermalink zu diesem Abschnitt
| Feld | Typ | Beschreibung |
|---|---|---|
book | string | Sportsbook für diese Seite |
selection | string | Name der Auswahl |
selection_type | string|null | Welche Seite eines Over/Under-Middles das ist: "over" auf side1 und "under" auf side2 bei Totals, Team-Totals und Spieler-Props. null auf beiden Seiten eines Spread-artigen Middles (Point Spread, Puck Line, Game Spread, Asian und Set Handicap, Halbzeit- und Viertel-Spreads), wo selection das Team nennt. Immer vorhanden. Dieselbe Bedeutung wie selection_type auf einer /odds-Zeile, hier beschränkt auf over und under. Lesen Sie die Seite aus diesem Feld, nicht aus selection: selection ist die eigene Bezeichnung des Sportsbooks und kann der Name des Spielers, eine lokalisierte Bezeichnung oder Yes/No bei einem Prognosemarkt sein. |
line | number | Linienwert bei diesem Sportsbook |
odds_american | number | Amerikanische Quoten |
odds_decimal | number | Dezimalquoten |
odds_probability | number | Implizite Wahrscheinlichkeit (0-1) |
fair_probability | number | Faire Wahrscheinlichkeit, bereinigt um Overround |
stake_percent | number | Empfohlene Einsatzaufteilung (% der Gesamtsumme) |
odds_age_seconds | number|null | Alter der Quoten dieser Seite zum Erkennungszeitpunkt |
deep_link | string|null | Weiterleitungsadresse für die Wette dieser Seite, https://api.sharpapi.io/api/v1/deeplink/{id}?state=XX — die Deeplink-Weiterleitung, gebildet wie der deep_link eines Arbitrage-Legs. Der Schlüssel ist immer vorhanden: null, wenn das Sportsbook keinen Link geliefert hat. Das ?state=-Suffix ist der state-Parameter der Anfrage, ohne Angabe pa. |
Warn-FlagsPermalink zu diesem Abschnitt
| Warnung | Bedeutung |
|---|---|
HIGH_PROBABILITY | Middle-Wahrscheinlichkeit übersteigt 15 % — ungewöhnlich hohe Trefferchance |
LARGE_GAP | Middle-Größe übersteigt 3 Punkte — Linien auf Korrektheit prüfen |
STALE_ODDS | Eine oder beide Quoten sind älter als 30 Sekunden |
LIVE_GAME | Spiel läuft derzeit |
GUARANTEED_PROFIT | Worst-Case-Verlust ist positiv — dies ist auch eine Arbitrage |
Detail-EndpunktPermalink zu diesem Abschnitt
Eine einzelne Middle-Gelegenheit über ihre ID abrufen.
GET /api/v1/opportunities/middles/:id| Parameter | Typ | Beschreibung |
|---|---|---|
id | path | Erforderlich. 16-stelliger Hex-Hash (z. B. a1b2c3d4e5f67890) |
Gibt ein einzelnes Middle-Objekt zurück (gleiches Schema wie die Listenelemente). Gibt 404 zurück, wenn nicht gefunden, 400 bei ungültigem ID-Format.
curl -X GET "https://api.sharpapi.io/api/v1/opportunities/middles/a1b2c3d4e5f67890" \
-H "X-API-Key: YOUR_API_KEY"Was sind Middles?Permalink zu diesem Abschnitt
Ein Middle entsteht, wenn zwei Sportsbooks unterschiedliche Linien für denselben Markt anbieten und damit eine numerische Lücke erzeugen, in der beide Wetten gleichzeitig gewinnen können.
Im Gegensatz zur Arbitrage (die Gewinn garantiert) bieten Middles die Chance, beide Seiten einer Wette zu gewinnen, wenn das Endergebnis in der „Mitte” der beiden Linien liegt.
Spread-Middle-BeispielPermalink zu diesem Abschnitt
DraftKings: Chiefs -2.5 @ -110
FanDuel: Bills +7.5 @ -108Sie wetten:
- Chiefs -2.5 bei DraftKings
- Bills +7.5 bei FanDuel
Mögliche Ergebnisse:
| Chiefs gewinnen mit | Chiefs -2.5 | Bills +7.5 | Ergebnis |
|---|---|---|---|
| 1-2 Punkten | Verlust | Gewinn | Split (kleiner Verlust) |
| 3, 4, 5, 6 oder 7 | Gewinn | Gewinn | MIDDLE GETROFFEN |
| 8+ Punkten | Gewinn | Verlust | Split (kleiner Verlust) |
Wenn die Chiefs mit 3-7 gewinnen, gewinnen beide Wetten. Die Zahlen 3 und 7 sind NFL-Schlüsselzahlen (Field Goal und Touchdown), wodurch dieses Middle besonders wertvoll wird.
SchlüsselzahlenPermalink zu diesem Abschnitt
Bestimmte Sportarten haben Punkteinkremente, die die Wahrscheinlichkeitsverteilung verstärken:
| Sportart | Schlüsselzahlen | Begründung |
|---|---|---|
| NFL | 3, 7, 10, 14 | Field Goal (3), Touchdown (7), Kombinationen |
| NHL | 1 | Die meisten Spiele werden mit 1 Tor entschieden (~47 %) |
| MLB | 1 | Die meisten Spiele werden mit 1 Run entschieden (~30 %) |
| Soccer | 1 | Die meisten Partien werden mit 1 Tor entschieden (~38 %) |
Wenn ein Middle Schlüsselzahlen enthält, heben die Felder key_numbers und key_number_probability dies hervor. Ein NFL-Middle, das 3 und 7 umfasst, hat eine kombinierte Schlüsselzahlen-Wahrscheinlichkeit von ~24,2 %.
Garantierter Gewinn (Arb + Middle)Permalink zu diesem Abschnitt
Wenn is_guaranteed_profit true ist, ist das Middle gleichzeitig eine Arbitrage — selbst der Worst Case bringt Gewinn. Dies ist die seltenste und wertvollste Art von Middle. Das Feld guaranteed_roi zeigt die Mindestrendite, selbst wenn das Middle verfehlt wird.
Leitfaden für Middle-GrößenPermalink zu diesem Abschnitt
| Middle-Größe | Qualität | Typische Märkte |
|---|---|---|
| 0,5 Punkte | Schmal | Seltene Gelegenheiten, niedrige Trefferquote |
| 1,0 Punkte | Standard | Üblich bei Spreads und Totals |
| 1,5 - 2,0 Punkte | Gut | Aktiv nach diesen suchen |
| 2,5+ Punkte | Hervorragend | Selten, aber hochprofitabel |
Verwenden Sie min_size=1, um schmale Middles herauszufiltern. Größere Middles haben eine höhere Wahrscheinlichkeit, in die Lücke zu fallen, was sie über die Zeit gleichmäßiger profitabel macht.
RisikoaspektePermalink zu diesem Abschnitt
Middles sind nicht risikofrei wie Arbitrage (es sei denn, is_guaranteed_profit ist true). Wenn das Ergebnis außerhalb des Middles liegt, verlieren Sie die Marge auf der verlierenden Seite (typischerweise 4-5 % einer Wette). Wenn ein Middle jedoch trifft, gewinnen Sie beide Wetten, was dies langfristig mehr als ausgleicht.
Aktualität der QuotenPermalink zu diesem Abschnitt
Das Feld odds_age_seconds zeigt, wie alt die zugrunde liegenden Quoten zum Erkennungszeitpunkt waren. Jede Seite hat zudem ihr eigenes odds_age_seconds. Überschreitet eine der Seiten 30 Sekunden, wird die Warnung STALE_ODDS hinzugefügt. Veraltete Quoten haben sich möglicherweise bereits bewegt — handeln Sie schnell bei frischen Gelegenheiten.
Best PracticesPermalink zu diesem Abschnitt
- Auf größere Middles fokussieren — Setzen Sie
min_sizeauf mindestens 1,0 für bessere Trefferquoten - Auf Schlüsselzahlen achten — Middles, die NFL 3/7 oder NHL/MLB/Soccer 1 enthalten, haben erhöhte Trefferquoten
- Garantierten Gewinn priorisieren — Filtern Sie nach
is_guaranteed_profit, um risikofreie Gelegenheiten zu finden - Quotenfrische prüfen — Ein niedriger
odds_age_seconds-Wert bedeutet, dass die Linien aktuell und handlungsfähig sind - Mit dem Summary-Endpunkt kombinieren — Verwenden Sie
/middles/summaryfür Dashboard-Übersichten - Schnell handeln — Linien konvergieren, sobald die Books anpassen, und schließen damit das Middle-Fenster
- Streaming nutzen — Abonnieren Sie
middles:detected-Events über SSE oder WebSocket für Echtzeit-Benachrichtigungen
Verwandte EndpunktePermalink zu diesem Abschnitt
- Middles-Zusammenfassung — Aggregierte Statistiken ohne die vollständige Liste
- +EV-Gelegenheiten — Wetten mit positivem Erwartungswert
- Arbitrage-Gelegenheiten — Gelegenheiten mit garantiertem Gewinn
- SSE-Stream — Echtzeit-Events
middles:detectedundmiddles:expired - Beste Quoten — Quoten über alle Books hinweg vergleichen