OddsHub – Anbindung

Technische Dokumentation für angebundene Plattformen · Stand dieser Seite: 2026-08-31

Schnellstart

OddsHub liefert fertig gerechnete Quoten über eine REST-API in einem einheitlichen Format. Alles ist JSON, alle Zeitangaben sind UTC im ISO-Format.

Basis-Adresse: https://www.atlasoddshub.com

# 1. Erreichbarkeit prüfen (ohne Schlüssel)
curl https://www.atlasoddshub.com/v1/health

# 2. Welche Sportarten liegen an?
curl -H "Authorization: Bearer IHR_SCHLUESSEL" https://www.atlasoddshub.com/v1/sports

# 3. Kompletter Feed mit fertigen Quoten
curl -H "Authorization: Bearer IHR_SCHLUESSEL" https://www.atlasoddshub.com/v1/feed

# 4. Nur Live-Spiele einer Sportart
curl -H "Authorization: Bearer IHR_SCHLUESSEL" "https://www.atlasoddshub.com/v1/feed?sport=soccer&status=live"

In aller Regel genügt ein einziger Endpunkt: /v1/feed. Er liefert Spiele, Spielstände und alle Quoten in einem Zug – fertig gerechnet und direkt einsetzbar, ohne Nacharbeit auf Ihrer Seite.

Zugang & Schlüssel

Jeder Kunde erhält einen eigenen Schlüssel (Format ohk_…). Er wird genau einmal im Klartext ausgegeben; danach liegt bei uns nur noch ein Hash. Geht er verloren, stellen wir einen neuen aus.

Übergabe

Bevorzugt im Kopf der Anfrage:

Authorization: Bearer ohk_xxxxxxxxxxxxxxxxxxxxxxxx

Alternativ – etwa für schnelle Tests im Browser:

X-API-Key: ohk_xxxxxxxxxxxxxxxxxxxxxxxx
https://www.atlasoddshub.com/v1/feed?apiKey=ohk_xxxxxxxxxxxxxxxxxxxxxxxx

Den Schlüssel niemals in eine Anwendung geben, die beim Endkunden läuft (Web-Seite, App). Er gehört auf Ihren Server; von dort holen Sie die Daten und geben sie an Ihre Oberfläche weiter. Ein Schlüssel im Browser ist für jeden Besucher lesbar.

Rechte

`feed`	Lesender Zugriff auf Quoten und Spiele. Das ist der normale Kundenschlüssel.
`admin`	Interne Verwaltung. Wird an Kunden nicht vergeben.

Mehrere Schlüssel je Kunde sind üblich: einer für die Testumgebung, einer für den Wirkbetrieb. So lässt sich ein einzelner Zugang sperren, ohne den Betrieb zu stören.

Endpunkte

Endpunkt	Zweck
`GET /v1/health`	Erreichbarkeit. Ohne Schlüssel abrufbar, ideal für die Überwachung.
`GET /v1/sports`	Sportarten mit Anzahl der bepreisten Spiele und davon live.
`GET /v1/events`	Spielliste ohne Quoten – schlank, für Übersichten und Abgleiche.
`GET /v1/events/{id}`	Ein einzelnes Spiel mit allen Märkten und Quoten.
`GET /v1/feed`	Hauptabruf: alle Spiele samt fertigen Quoten. Blättert über `offset`/`limit`.
`GET /v1/feed/delta`	Laufender Betrieb: nur die Änderungen seit Ihrem letzten Stand (`?since=`).

Parameter von `/v1/feed` und `/v1/events`

Parameter	Beispiel	Bedeutung
`sport`	`soccer`	Nur eine Sportart. Schlüssel siehe `/v1/sports`.
`status`	`live`	`live` oder `prematch`. Ohne Angabe: beides.
`league`	`Bundesliga`	Nur eine Liga (nur `/v1/events`).
`markets`	`h2h,totals`	Nur diese Marktarten ausgeben (nur `/v1/feed`).
`limit`	`200`	Spiele je Seite. Feed bis 1000, Eventliste bis 500.
`offset`	`500`	Nur `/v1/feed`: nächste Seite. Weiterblättern, solange `hasMore` true ist.
`since`	`10423`	Nur `/v1/feed/delta`: Ihr letzter `seq`-Stand.
`all`	`1`	Nur `/v1/events`: auch Spiele ohne aktuelle Quoten anzeigen.

Datenformat

Antwort von GET /v1/feed (gekürzt):

{
  "generatedAt": "2026-08-09T01:42:38.000Z",
  "customer": { "name": "MegaBet Ltd.",
                "settings": { "marginPrematch": 1.07, "marginLive": 1.12, "…": "…" } },
  "count": 42,
  "events": [
    {
      "id": 3312,
      "sport":  { "key": "soccer", "name": "Fußball" },
      "league": "Bundesliga",
      "home":   "Borussia Mönchengladbach",
      "away":   "VfL Wolfsburg",
      "wappenHeim": "borussia-monchengladbach.svg",
      "wappenGast": "vfl-wolfsburg.svg",
      "wappenLiga": "bundesliga-germany.svg",
      "startsAt": "2026-08-09T01:02:43.000Z",
      "status": "live",
      "score":  { "home": 2, "away": 1, "minute": 47, "period": "2H" },
      "halftime": { "home": 1, "away": 1 },
      "cards":  { "yellow": { "home": 2, "away": 3 }, "red": { "home": 0, "away": 1 }, "yellowRed": { "home": 1, "away": 0 } },
      "corners": { "home": 4, "away": 2 },
      "lastUpdate": "2026-08-09 01:42:38",
      "markets": [
        {
          "key": "h2h", "name": "Siegwette", "line": null, "descriptor": null,
          "outcomes": [
            { "name": "1", "odds": 1.42 },
            { "name": "X", "odds": 4.10 },
            { "name": "2", "odds": 7.20 }
          ]
        },
        {
          "key": "totals", "name": "Über/Unter", "line": 2.5, "descriptor": null,
          "outcomes": [
            { "name": "Über",  "odds": 1.75 },
            { "name": "Unter", "odds": 2.05 }
          ]
        }
      ]
    }
  ]
}

Felder eines Spiels

`id`	Feste Kennung bei OddsHub. Bleibt über die gesamte Laufzeit des Spiels gleich – der richtige Schlüssel für Ihre Zuordnung.
`status`	`prematch` (noch nicht angepfiffen) · `live` (läuft) · beendete Spiele erscheinen nicht mehr im Feed.
`startsAt`	Anstoß, UTC (ISO 8601).
`score`	Nur bei `live`: Spielstand, Minute und Abschnitt (`1H`, `HT`, `2H`, `ET`; bei Satzsportarten `S1`–`S5` für den laufenden Satz, `live` = läuft ohne Abschnittsangabe). Dazu, sofern der Anbieter sie liefert: `spielzeit` (gespielte Zeit „mm:ss"), `uhrSteht` (`true` = Spieluhr angehalten), `restzeit` und `restzeitAbschnitt` (Countdown-Sportarten). `null` heißt „nicht gemeldet".
`superturnier`	Übergeordneter Wettbewerb der Liga (z. B. der Gesamtwettbewerb über seinen Qualifikationsrunden), sofern gemeldet; sonst `null`.
`halftime`, `cards`	Halbzeitstand und Kartenstand, sofern verfügbar. `null` heißt „unbekannt", nicht „keine" – auch bei den Einzelwerten im Block. `cards.yellowRed` (Gelb-Rot) ist nicht in `red` enthalten; wer Platzverweise anzeigt, rechnet `red + yellowRed`.
`corners`	Eckenstand, sofern verfügbar; gleiche Regel: `null` heißt „unbekannt".
`wappenHeim`, `wappenGast`, `wappenLiga`	Dateiname des Vereins- bzw. Ligawappens (z. B. `agf-aarhus.svg`) – stabil auch dann, wenn der Feed denselben Verein zeitweise anders schreibt. Die Bilddateien liefert Ihre Plattform selbst aus; der Feed nennt nur den Dateinamen. `null` heißt: kein eindeutiges Wappen im Bestand – zeigen Sie dann bitte Ihren eigenen Platzhalter (z. B. Initialen), niemals ein geratenes Wappen. Die Felder stehen auch im `finished`-Block.
`lastUpdate`	Letzte Änderung an diesem Spiel bei OddsHub.

Felder eines Marktes

`key`	Marktart aus dem Katalog unten – der stabile Schlüssel für Ihre Verarbeitung.
`name`	Deutscher Anzeigename. Für die Logik bitte immer `key` verwenden, nicht den Namen.
`line`	Linie des Marktes, z. B. `2.5` bei Über/Unter oder `-1` beim Handicap. `null`, wenn der Markt keine führt.
`descriptor`	Bezugsobjekt, z. B. der Spielername bei Spielerwetten. Sonst `null`.
`outcomes[].name`	Bezeichnung der Auswahl, z. B. `1`/`X`/`2` oder `Über`/`Unter`. Der stabile Schlüssel der Auswahl – bitte immer diesen abrechnen, nie den Anzeigetext.
`outcomes[].label`	Anzeigetext, wenn `name` für sich nicht lesbar ist – bei den Torschützenmärkten der Spielername. Das Feld fehlt, wo die Auswahl für sich spricht.
`outcomes[].odds`	Die fertige Quote – inklusive Ihrer im Portal eingestellten Marge.

Wie die Quote entsteht

Sie erhalten je Auswahl eine fertige Quote. Darin steckt bereits alles: unsere Bepreisung und die Marge, die Sie selbst im Kundenportal festlegen – getrennt für Vorab- und Livewetten. Weitere Umrechnungen sind auf Ihrer Seite nicht nötig.

Welche Marge beim jeweiligen Abruf angewendet wurde, steht in jeder Antwort unter customer.settings.

Marktkatalog

Jede Marktart hat einen festen Schlüssel – daran richten Sie Ihre Verarbeitung aus. „Vollständig" heißt: die Auswahlen decken alle Ausgänge überschneidungsfrei ab; nur dort wirkt eine Marge als Overround über den gesamten Markt.

Schlüssel	Markt	Vollständig	line	descriptor
`h2h`	Siegwette	ja	–	–
`totals`	Über/Unter	ja	Tor-/Punktelinie	–
`spreads`	Handicap	ja	Handicap-Wert (Sicht Heim)	–
`btts`	Beide Teams treffen	ja	–	–
`double_chance`	Doppelte Chance	nein	–	–
`correct_score`	Genaues Ergebnis	ja	–	–
`h2h_2w`	Sieger (2-Weg)	ja	–	–
`odd_even`	Gerade/Ungerade	ja	–	–
`totals_home`	Über/Unter Heimmannschaft	ja	Tor-/Punktelinie	–
`totals_away`	Über/Unter Gastmannschaft	ja	Tor-/Punktelinie	–
`totals_p`	Über/Unter Abschnitt	ja	Tor-/Punktelinie	Abschnittsnummer
`h2h_rest`	Restspielzeit-Sieger	ja	–	Spielstand zum Marktbeginn („Stand 1:0")
`btts_h1`	Beide treffen 1. Halbzeit	ja	–	–
`btts_h2`	Beide treffen 2. Halbzeit	ja	–	–
`totals_h2`	Über/Unter 2. Halbzeit	ja	Torlinie 2. Halbzeit	–
`totals_home_h1`	Über/Unter Heimmannschaft 1. Halbzeit	ja	Tor-/Punktelinie	–
`totals_away_h1`	Über/Unter Gastmannschaft 1. Halbzeit	ja	Tor-/Punktelinie	–
`spreads_h1`	Handicap 1. Halbzeit	ja	Handicap-Wert (Sicht Heim)	–
`spreads_h2`	Handicap 2. Halbzeit	ja	Handicap-Wert (Sicht Heim)	–
`odd_even_h1`	Gerade/Ungerade 1. Halbzeit	ja	–	–
`odd_even_h2`	Gerade/Ungerade 2. Halbzeit	ja	–	–
`draw_no_bet_h1`	Unentschieden – Einsatz zurück 1. Halbzeit	nein	–	–
`draw_no_bet_h2`	Unentschieden – Einsatz zurück 2. Halbzeit	nein	–	–
`correct_score_h2`	Genaues Ergebnis 2. Halbzeit	ja	–	–
`h2h_p`	Siegwette Abschnitt	ja	–	Abschnittsnummer
`h2h_2w_p`	Sieger Abschnitt (2-Weg)	ja	–	Abschnittsnummer
`spreads_p`	Handicap Abschnitt	ja	Handicap-Wert (Sicht Heim)	Abschnittsnummer
`odd_even_p`	Gerade/Ungerade Abschnitt	ja	–	Abschnittsnummer
`draw_no_bet_p`	Unentschieden – Einsatz zurück Abschnitt	nein	–	Abschnittsnummer
`totals_home_p`	Über/Unter Heimmannschaft Abschnitt	ja	Tor-/Punktelinie	Abschnittsnummer
`totals_away_p`	Über/Unter Gastmannschaft Abschnitt	ja	Tor-/Punktelinie	Abschnittsnummer
`spreads_sets`	Satz-Handicap	ja	Satz-Handicap (Sicht Heim)	–
`corners_total`	Über/Unter Ecken	ja	Eckenlinie	–
`corners_total_3w`	Eckbälle (Über/Genau/Unter)	ja	Eckenzahl	–
`totals_runs`	Über/Unter Runs	ja	Run-Linie	–
`totals_runs_home`	Über/Unter Runs Heimmannschaft	ja	Run-Linie	–
`totals_runs_away`	Über/Unter Runs Gastmannschaft	ja	Run-Linie	–
`overtime_yesno`	Gibt es eine Verlängerung?	ja	–	–
`extra_innings_yesno`	Gibt es Extra Innings?	ja	–	–
`go_the_distance`	Geht der Kampf über die volle Distanz?	ja	–	–
`clean_sheet_home`	Heimmannschaft ohne Gegentor	ja	–	–
`clean_sheet_away`	Gastmannschaft ohne Gegentor	ja	–	–
`score_both_halves_home`	Heimmannschaft trifft in beiden Halbzeiten	ja	–	–
`score_both_halves_away`	Gastmannschaft trifft in beiden Halbzeiten	ja	–	–
`cards_total`	Über/Unter Karten	ja	Kartenlinie	–
`cards_h2h`	Meiste Karten	ja	–	–
`cards_total_h1`	Über/Unter Karten 1. Halbzeit	ja	Kartenlinie	–
`red_card`	Rote Karte im Spiel	ja	–	–
`player_card`	Spieler sieht Karte	ja	–	Spielername
`player_prop`	Torschütze	nein	–	Spielername
`h2h_ht`	Siegwette 1. Halbzeit	ja	–	–
`h2h_2h`	Siegwette 2. Halbzeit	ja	–	–
`double_chance_ht`	Doppelte Chance 1. Halbzeit	nein	–	–
`double_chance_2h`	Doppelte Chance 2. Halbzeit	nein	–	–
`ht_ft`	Halbzeit/Endstand	ja	–	–
`correct_score_ht`	Genaues Ergebnis 1. Halbzeit	ja	–	–
`totals_ht`	Über/Unter 1. Halbzeit	ja	Torlinie 1. Halbzeit	–
`spreads_ht`	Handicap 1. Halbzeit	ja	Handicap-Wert 1. Halbzeit (Sicht Heim)	–
`dnb_ht`	Unentschieden 1. Halbzeit – Einsatz zurück	ja	–	–
`exakte_tore_h1`	Anzahl Tore 1. Halbzeit (genau)	ja	–	Staffelung („bis 2+")
`dnb`	Unentschieden – Einsatz zurück	ja	–	–
`hnb`	Ohne Heimsieg – Einsatz zurück	ja	–	–
`anb`	Ohne Gastsieg – Einsatz zurück	ja	–	–
`ht_ft_ergebnis`	Halbzeit/Endstand (genaues Ergebnis)	ja	–	–
`eur_handicap`	Europäisches Handicap	ja	Handicap-Wert (Sicht Heim, ganze Zahl)	–
`naechstes_tor`	Nächstes Tor	ja	Nummer des Tores	–
`letztes_tor`	Letztes Tor	ja	–	–
`winning_margin`	Siegabstand	ja	–	–
`satz_sieger`	Satzsieger	ja	Satznummer	–
`gesamt_saetze`	Anzahl Sätze	ja	–	–
`spiele_gesamt`	Spiele/Punkte gesamt	ja	Spiel-/Punktelinie	–
`spiele_im_satz`	Spiele/Punkte im Satz	ja	Spiel-/Punktelinie	Satznummer („Satz 2")
`spiele_hcp`	Spiele-/Punkte-Handicap	ja	Handicap-Wert (Sicht Heim)	Satznummer („Satz 2"), leer = ganzes Match
`odd_even_spiele`	Spiele gerade/ungerade	ja	–	–
`naechstes_tor_ht`	Nächstes Tor 1. Halbzeit	ja	Nummer des Tores in der 1. Halbzeit	–
`naechstes_tor_2h`	Nächstes Tor 2. Halbzeit	ja	Nummer des Tores in der 2. Halbzeit	–
`satz_ergebnis`	Satzergebnis	nein	–	–
`satz_genau`	Genaues Satzergebnis	nein	–	Satznummer („Satz 2")
`race_zu_spielen`	Wer erreicht X Spiele zuerst	nein	Ziel-Spielezahl	Satznummer („Satz 2")
`totals_viertel`	Über/Unter Viertel	ja	Punktelinie	Viertelnummer („Viertel 2")
`torschuetze_n`	N-ter Torschütze	nein	Nummer des Tores (1 = erster Torschütze)	–
`torschuetze_letzter`	Letzter Torschütze	nein	–	–
`torschuetze_beliebig`	Torschütze irgendwann	nein	–	–
`frame_sieger`	Frame-Sieger	ja	Framenummer	–
`race_zu_ecken`	Wer erreicht X Ecken zuerst	ja	Ziel-Eckenzahl	–
`corners_total_3w_ht`	Ecken 1. Halbzeit (Über/Genau/Unter)	ja	Eckenzahl 1. Halbzeit	–
`ohne_satzverlust`	Sieg ohne Satzverlust	ja	–	–
`ohne_satzverlust_heim`	Heim gewinnt ohne Satzverlust	ja	–	–
`ohne_satzverlust_gast`	Gast gewinnt ohne Satzverlust	ja	–	–
`race_zu_punkten`	Wer erreicht X Punkte zuerst	nein	Ziel-Punktezahl	Satznummer („Satz 2")
`race_zu_punkten_3w`	Wer erreicht X Punkte zuerst (3-Weg)	ja	Ziel-Punktezahl	Spielabschnitt („1. Halbzeit", „Viertel 2")
`race_zu_toren_3w`	Wer erreicht X Tore zuerst	ja	Ziel-Torzahl	Spielabschnitt („2. Halbzeit")
`race_zu_runs_3w`	Wer erreicht X Runs zuerst (3-Weg)	ja	Ziel-Runzahl	–
`race_zu_hits_3w`	Wer erreicht X Hits zuerst	ja	Ziel-Hitzahl	–
`race_zu_punkten_ot`	Wer erreicht X Punkte zuerst (inkl. Verlängerung)	nein	Ziel-Punktezahl	–
`race_zu_frames`	Wer erreicht X Frames zuerst	nein	Ziel-Framezahl	–
`frame_race_zu_30`	Rennen auf 30 Punkte im Frame	nein	Framenummer	–
`elfmeter_sieger`	Wer gewinnt das Elfmeterschießen?	ja	–	–
`elfmeter_verwandelt`	Wird der Elfmeter verwandelt?	ja	Elfmeternummer	–
`elfmeter_ergebnis`	Elfmeterschießen – Genaues Ergebnis	nein	–	–
`spiele_spieler`	Anzahl Spiele eines Spielers	ja	Spielelinie	„Heim" oder „Gast"
`tiebreaks_gesamt`	Anzahl Tie Breaks	ja	Tie-Break-Linie	–
`doppel_ergebnis_satz`	Doppeltes Ergebnis (1. Satz / Match)	ja	–	–
`satzstand_nach_spielen`	Satzstand nach N Spielen	nein	–	Satz und Spielezahl („Satz 2 nach 4 Spielen")
`fuehrung_nach_spielen`	In Führung nach N Spielen	ja	Spielezahl	Satznummer („Satz 2")
`satz_genau_beliebig`	Genaues Satzergebnis (beliebiger Spieler)	nein	–	Satznummer („Satz 2")
`satz_genau_gruppe`	Genaues Satzergebnis (Gruppe)	nein	–	Satznummer („Satz 2")
`sieg_und_tore`	Sieg & Tore	ja	Torlinie	–
`meiste_180er`	Meiste 180er	ja	–	–
`eur_handicap_ht`	Europäisches Handicap 1. Halbzeit	ja	Handicap-Wert (Sicht Heim, ganze Linie)	–
`h2h_rest_ht`	Rest der 1. Halbzeit	ja	–	Spielstand zum Marktbeginn („Stand 1:0")
`tore_genau_heim`	Tore Heimmannschaft (genau)	ja	–	–
`tore_genau_gast`	Tore Gastmannschaft (genau)	ja	–	–
`sieg_und_btts`	Sieg und beide treffen	ja	–	–
`sieg_und_btts_h1`	Sieg und beide treffen – 1. Halbzeit	ja	–	–
`sieg_und_tore_h1`	Sieg & Tore – 1. Halbzeit	ja	Torlinie 1. Halbzeit	–
`tore_und_btts`	Tore & beide treffen	ja	Torlinie	–
`spielentscheidung`	Womit wird das Spiel entschieden?	ja	–	–
`naechste_runde`	Wer kommt in die nächste Runde?	ja	–	–
`sieg_in_verlaengerung`	Sieg in der Verlängerung?	ja	–	–
`sieg_nach_elfmeter`	Sieg nach Elfmeterschießen?	ja	–	–
`scores_2h_home`	Heimmannschaft trifft in 2. Halbzeit	ja	–	–
`scores_2h_away`	Gastmannschaft trifft in 2. Halbzeit	ja	–	–
`satzgewinn_heim`	Heim gewinnt einen Satz	ja	–	–
`satzgewinn_gast`	Gast gewinnt einen Satz	ja	–	–
`exakte_tore`	Anzahl Tore (genau)	ja	–	Staffelung („bis 5+")
`torbereich`	Torbereich	ja	–	Staffelung („bis 7+")
`odd_even_home`	Tore Heimmannschaft gerade/ungerade	ja	–	–
`odd_even_away`	Tore Gastmannschaft gerade/ungerade	ja	–	–
`wer_trifft`	Welche Mannschaft trifft	ja	–	–
`odd_even_im_satz`	Punkte im Satz gerade/ungerade	ja	–	Satznummer („Satz 2")
`dc_und_tore`	Doppelte Chance & Tore	nein	Torlinie	–
`dc_und_btts`	Doppelte Chance und beide treffen	nein	–	–
`seite_oder_tore`	Sieg oder Über/Unter	ja	Torlinie	Seite und Richtung („Heim oder Über")
`seite_oder_btts`	Sieg oder beide treffen	ja	–	Seite („Heim"/„X"/„Gast")
`seite_oder_zu_null`	Sieg oder zu Null	ja	–	Seite („Heim"/„X"/„Gast")
`sieg_zu_null_heim`	Heim gewinnt zu Null	ja	–	–
`sieg_zu_null_gast`	Gast gewinnt zu Null	ja	–	–
`torreichste_haelfte`	Torreichste Hälfte	ja	–	–
`torreichste_haelfte_heim`	Torreichste Hälfte Heim	ja	–	–
`torreichste_haelfte_gast`	Torreichste Hälfte Gast	ja	–	–
`beide_haelften_tore`	Beide Hälften Über/Unter	ja	Torlinie je Hälfte	Richtung („Über"/„Unter")
`dnb_h2`	Unentschieden 2. Halbzeit – Einsatz zurück	ja	–	–
`eur_handicap_2h`	Europäisches Handicap 2. Halbzeit	ja	Handicap-Wert 2. Halbzeit (Sicht Heim, ganze Zahl)	–
`totals_home_h2`	Über/Unter Heimmannschaft 2. Halbzeit	ja	Tor-/Punktelinie	–
`totals_away_h2`	Über/Unter Gastmannschaft 2. Halbzeit	ja	Tor-/Punktelinie	–
`exakte_tore_h2`	Anzahl Tore 2. Halbzeit (genau)	ja	–	Staffelung („bis 2+")
`clean_sheet_home_h1`	Heim ohne Gegentor 1. Halbzeit	ja	–	–
`clean_sheet_away_h1`	Gast ohne Gegentor 1. Halbzeit	ja	–	–
`clean_sheet_home_h2`	Heim ohne Gegentor 2. Halbzeit	ja	–	–
`clean_sheet_away_h2`	Gast ohne Gegentor 2. Halbzeit	ja	–	–
`heim_gewinnt`	Heim gewinnt (Ja/Nein)	ja	–	–
`gast_gewinnt`	Gast gewinnt (Ja/Nein)	ja	–	–
`irgendwer_gewinnt`	Ein Team gewinnt (kein Remis)	ja	–	–
`gewinnt_beide_haelften_heim`	Heim gewinnt beide Hälften	ja	–	–
`gewinnt_beide_haelften_gast`	Gast gewinnt beide Hälften	ja	–	–
`gewinnt_eine_haelfte_heim`	Heim gewinnt eine Hälfte	ja	–	–
`gewinnt_eine_haelfte_gast`	Gast gewinnt eine Hälfte	ja	–	–
`btts_beide_haelften`	Beide treffen 1./2. Halbzeit	ja	–	–
`sieg_und_btts_h2`	Sieg und beide treffen – 2. Halbzeit	ja	–	–
`sieg_und_tore_h2`	Sieg & Tore – 2. Halbzeit	ja	Torlinie 2. Halbzeit	–
`dc_und_btts_h1`	Doppelte Chance und beide treffen – 1. Halbzeit	nein	–	–
`dc_und_btts_h2`	Doppelte Chance und beide treffen – 2. Halbzeit	nein	–	–
`dc_spiel_und_btts_h1`	Doppelte Chance (Spiel) & beide treffen 1. Halbzeit	nein	–	–
`dc_spiel_und_btts_h2`	Doppelte Chance (Spiel) & beide treffen 2. Halbzeit	nein	–	–
`multi_tore_heim`	Multi-Tore Heimmannschaft	nein	–	–
`multi_tore_gast`	Multi-Tore Gastmannschaft	nein	–	–
`multi_tore_h1`	Multi-Tore 1. Halbzeit	nein	–	–
`multi_tore_h2`	Multi-Tore 2. Halbzeit	nein	–	–
`tor_intervall`	Wann fällt das Tor?	ja	Nummer des Tores	–
`multi_score`	Multi-Ergebnis	ja	–	–
`tor_intervall_15`	Wann fällt das Tor? (15-Minuten-Fenster)	ja	Nummer des Tores	–
`zehn_minuten_1x2`	1X2 der Minuten 1–10	ja	–	–
`sieg_xup`	Siegwette mit Frühauszahlung (X-Up)	nein	Tore Vorsprung für die Frühauszahlung	–
`gewinnt_genau_1_satz_heim`	Heim gewinnt genau einen Satz	ja	–	–
`gewinnt_genau_1_satz_gast`	Gast gewinnt genau einen Satz	ja	–	–
`gewinnt_genau_2_saetze_heim`	Heim gewinnt genau zwei Sätze	ja	–	–
`gewinnt_genau_2_saetze_gast`	Gast gewinnt genau zwei Sätze	ja	–	–
`satz_zu_null`	Ein Satz zu Null	ja	–	–
`vierter_satz`	Gibt es einen 4. Satz?	ja	–	–
`fuenfter_satz`	Gibt es einen 5. Satz?	ja	–	–
`sieg_und_spiele`	Sieg & Spiele Über/Unter	ja	–	–
`elfmeterschiessen`	Kommt es zum Elfmeterschießen?	ja	–	–
`sieger_super_over`	Sieger (inkl. Super Over)	ja	–	–
`kampf_siegart`	Wie wird der Kampf entschieden?	ja	–	–
`kampf_sieger_runde`	Sieger & Runde	ja	–	–
`kampf_sieger_rundenbereich`	Sieger & Rundenbereich	ja	–	–
`satz_ergebnis_legs`	Genaues Satzergebnis (in Legs)	ja	–	–
`darts_180_erste`	Wer wirft die erste 180?	ja	–	–
`darts_180_hcp`	180er-Handicap	ja	180er-Handicap (Sicht Heim)	–
`darts_180_total`	Über/Unter 180er	ja	180er-Linie	–
`darts_180_total_heim`	Über/Unter 180er Heim	ja	180er-Linie	–
`darts_180_total_gast`	Über/Unter 180er Gast	ja	180er-Linie	–
`frames_total`	Über/Unter Frames	ja	Frame-Linie	–
`winning_margin_ht`	Siegabstand 1. Halbzeit	ja	–	–
`punktbereich_ht`	Punktbereich 1. Halbzeit	ja	–	–
`hoechste_periode`	Torreichstes Drittel	ja	–	–
`btts_p`	Beide treffen im Abschnitt	ja	–	–
`dnb_p`	Sieger des Abschnitts (Einsatz zurück bei Remis)	ja	–	–
`dc_p`	Doppelte Chance im Abschnitt	ja	–	–
`try_1x2`	Tries 1X2	ja	–	–
`try_dc`	Tries Doppelte Chance	ja	–	–
`try_dnb`	Mehr Tries (Einsatz zurück bei Gleichstand)	ja	–	–
`try_eur_hcp`	Try-Handicap (Startstand)	ja	–	–
`try_hcp`	Try-Handicap	ja	–	–
`try_total`	Über/Unter Tries	ja	–	–
`try_total_heim`	Über/Unter Tries Heim	ja	–	–
`try_total_gast`	Über/Unter Tries Gast	ja	–	–
`try_odd_even`	Tries gerade/ungerade	ja	–	–
`try_1x2_ht`	Tries 1X2 – 1. Halbzeit	ja	–	–
`try_dc_ht`	Tries Doppelte Chance – 1. Halbzeit	ja	–	–
`try_dnb_ht`	Mehr Tries 1. Halbzeit (Einsatz zurück bei Gleichstand)	ja	–	–
`try_eur_hcp_ht`	Try-Handicap 1. Halbzeit (Startstand)	ja	–	–
`try_hcp_ht`	Try-Handicap 1. Halbzeit	ja	–	–
`try_total_ht`	Über/Unter Tries 1. Halbzeit	ja	–	–
`try_total_heim_ht`	Über/Unter Tries Heim 1. Halbzeit	ja	–	–
`try_total_gast_ht`	Über/Unter Tries Gast 1. Halbzeit	ja	–	–
`try_odd_even_ht`	Tries gerade/ungerade 1. Halbzeit	ja	–	–
`sieger_ot`	Sieger (inkl. Verlängerung)	ja	–	–
`spreads_ot`	Handicap (inkl. Verlängerung)	ja	–	–
`totals_ot`	Über/Unter (inkl. Verlängerung)	ja	–	–
`totals_home_ot`	Über/Unter Heim (inkl. Verlängerung)	ja	–	–
`totals_away_ot`	Über/Unter Gast (inkl. Verlängerung)	ja	–	–
`odd_even_ot`	Gerade/Ungerade (inkl. Verlängerung)	ja	–	–
`winning_margin_ot`	Siegabstand (inkl. Verlängerung)	ja	–	–
`siegabstand_beliebig`	Siegabstand (egal wer)	ja	–	–
`sieg_und_punkte_ot`	Sieg & Punkte (inkl. Verlängerung)	ja	–	–
`h2_1x2_ot`	2. Halbzeit 1X2 (inkl. Verlängerung)	ja	–	–
`h2_dnb_ot`	2. Halbzeit Sieger (inkl. Verlängerung, Einsatz zurück bei Remis)	ja	–	–
`h2_hcp_ot`	2. Halbzeit Handicap (inkl. Verlängerung)	ja	–	–
`h2_total_ot`	2. Halbzeit Über/Unter (inkl. Verlängerung)	ja	–	–
`sieg_1x2_ot`	1X2 (inkl. Verlängerung)	ja	–	–
`dnb_ot`	Sieger (inkl. Verlängerung, Einsatz zurück bei Remis)	ja	–	–
`odd_even_home_ot`	Heim gerade/ungerade (inkl. Verlängerung)	ja	–	–
`odd_even_away_ot`	Gast gerade/ungerade (inkl. Verlängerung)	ja	–	–
`odd_even_home_h1`	Heim gerade/ungerade 1. Halbzeit	ja	–	–
`odd_even_away_h1`	Gast gerade/ungerade 1. Halbzeit	ja	–	–
`touchdowns_total`	Über/Unter Touchdowns	ja	–	–
`fieldgoals_total`	Über/Unter Field Goals	ja	–	–
`fieldgoal_nr`	Wer trifft das N-te Field Goal?	nein	–	–
`punktbereich`	Punktbereich	ja	–	–
`viertel_1x2`	1X2 im Viertel	ja	–	–
`viertel_dnb`	Sieger des Viertels (Einsatz zurück bei Remis)	ja	–	–
`viertel_hcp`	Handicap im Viertel	ja	–	–
`viertel_odd_even`	Gerade/Ungerade im Viertel	ja	–	–
`viertel_siegabstand`	Siegabstand im Viertel	ja	–	–
`viertel_total_heim`	Über/Unter Heim im Viertel	ja	–	–
`viertel_total_gast`	Über/Unter Gast im Viertel	ja	–	–
`hoechstes_viertel`	Punktreichstes Viertel	ja	–	–
`totals_3w`	Über/Genau/Unter	ja	–	–
`race_zu_runs`	Wer erreicht X Runs zuerst?	nein	–	–
`heim_schlaegt_9tes`	Heim schlägt im 9. Inning	ja	–	–
`mehr_innings_1x2`	Wer gewinnt mehr Innings?	ja	–	–
`hoechstes_inning_team`	Wer hat das punktreichste Inning?	ja	–	–
`hoechstes_inning`	Punktreichstes Inning	ja	–	–
`innings15_1x2`	Innings 1–5: 1X2	ja	–	–
`innings15_hcp`	Innings 1–5: Handicap	ja	–	–
`innings15_total`	Innings 1–5: Über/Unter	ja	–	–
`innings15_total_heim`	Innings 1–5: Über/Unter Heim	ja	–	–
`innings15_total_gast`	Innings 1–5: Über/Unter Gast	ja	–	–
`innings15_sieger`	Innings 1–5: Sieger	ja	–	–
`inning_1x2`	1X2 im Inning	ja	–	–
`inning_total`	Über/Unter im Inning	ja	–	–
`inning_sieger`	Sieger des Innings	ja	–	–
`inning_punktet_heim`	Heim punktet im Inning	ja	–	–
`inning_punktet_gast`	Gast punktet im Inning	ja	–	–
`max_runs_serie`	Längste Run-Serie eines Teams	ja	–	–
`entscheidung_wann`	Wann fällt die Entscheidung?	ja	–	–
`hits_total`	Über/Unter Hits	ja	–	–
`hits_total_heim`	Über/Unter Hits Heim	ja	–	–
`hits_total_gast`	Über/Unter Hits Gast	ja	–	–
`sieg_und_runs`	Sieg & Runs Über/Unter	ja	–	–
`karten_1x2`	Wer bekommt die meisten Karten?	ja	–	–
`karten_1x2_ht`	Meiste Karten 1. Halbzeit	ja	–	–
`karte_nr`	Wer bekommt die N-te Karte?	ja	–	–
`karte_nr_ht`	Wer bekommt die N-te Karte? – 1. Halbzeit	ja	–	–
`karten_punkte`	Über/Unter Karten-Punkte	ja	–	–
`karten_punkte_ht`	Über/Unter Karten-Punkte 1. Halbzeit	ja	–	–
`cards_total_ht`	Über/Unter Karten 1. Halbzeit	ja	–	–
`karten_genau`	Karten (genau)	ja	–	–
`karten_genau_ht`	Karten 1. Halbzeit (genau)	ja	–	–
`karten_genau_heim`	Karten Heim (genau)	ja	–	–
`karten_genau_gast`	Karten Gast (genau)	ja	–	–
`karten_genau_heim_ht`	Karten Heim 1. Halbzeit (genau)	ja	–	–
`karten_genau_gast_ht`	Karten Gast 1. Halbzeit (genau)	ja	–	–
`platzverweis`	Platzverweis im Spiel	ja	–	–
`platzverweis_heim`	Platzverweis Heim	ja	–	–
`platzverweis_gast`	Platzverweis Gast	ja	–	–
`platzverweis_ht`	Platzverweis 1. Halbzeit	ja	–	–
`platzverweis_heim_ht`	Platzverweis Heim 1. Halbzeit	ja	–	–
`platzverweis_gast_ht`	Platzverweis Gast 1. Halbzeit	ja	–	–
`corners_1x2`	Wer holt die meisten Ecken?	ja	–	–
`corners_1x2_ht`	Meiste Ecken 1. Halbzeit	ja	–	–
`ecke_nr`	Wer holt die N-te Ecke?	ja	–	–
`ecke_nr_ht`	Wer holt die N-te Ecke? – 1. Halbzeit	ja	–	–
`letzte_ecke`	Letzte Ecke	ja	–	–
`letzte_ecke_ht`	Letzte Ecke 1. Halbzeit	ja	–	–
`corners_hcp`	Ecken-Handicap	ja	–	–
`corners_hcp_ht`	Ecken-Handicap 1. Halbzeit	ja	–	–
`corners_total_home`	Über/Unter Ecken Heim	ja	–	–
`corners_total_away`	Über/Unter Ecken Gast	ja	–	–
`corners_total_ht`	Über/Unter Ecken 1. Halbzeit	ja	–	–
`ecken_bereich`	Eckenbereich	ja	–	–
`ecken_bereich_heim`	Eckenbereich Heim	ja	–	–
`ecken_bereich_gast`	Eckenbereich Gast	ja	–	–
`ecken_bereich_ht`	Eckenbereich 1. Halbzeit	ja	–	–
`odd_even_ecken`	Ecken gerade/ungerade	ja	–	–
`odd_even_ecken_ht`	Ecken gerade/ungerade 1. Halbzeit	ja	–	–
`ecken_genau_heim_ht`	Ecken Heim 1. Halbzeit (genau)	ja	–	–
`ecken_genau_gast_ht`	Ecken Gast 1. Halbzeit (genau)	ja	–	–
`multi_tore`	Multi-Tore	nein	–	–
`ht_ft_und_tore`	Halbzeit/Endstand & Tore	ja	Torlinie (ganzes Spiel)	–
`ht_ft_und_tore_h1`	Halbzeit/Endstand & Tore 1. Halbzeit	ja	Torlinie (1. Halbzeit)	–
`ht_ft_und_tore_genau`	Halbzeit/Endstand & Toranzahl	ja	–	–
`torschuetze_ot`	Torschütze (inkl. Verlängerung)	nein	–	–
`outright`	Langzeitwette	nein	–	–

Live-Daten

Live-Spiele erkennen Sie an status: "live". Sie führen zusätzlich score mit Spielstand, Minute und Spielabschnitt; im Fußball kommen Halbzeitstand und Karten dazu, sofern sie vorliegen.

Quoten laufender Spiele ändern sich fortlaufend – nach jedem Tor deutlich.
Beendete Spiele verschwinden aus dem Feed. Verlassen Sie sich für die Abrechnung nicht darauf, dass ein Spiel „noch da" ist, sondern auf Ihre eigene Kopie.
Ein Spiel ohne gültige Quoten wird nicht ausgeliefert. Ein ausgesetzter Markt fällt aus dem Feed und kommt bei Wiederaufnahme zurück.

Nehmen Sie eine Quote nie ungeprüft an, wenn zwischen Abruf und Annahme der Wette Zeit vergeht. Bei Live-Spielen sind wenige Sekunden viel. Üblich ist, unmittelbar vor der Annahme erneut abzugleichen.

Abruftakt

Die Quoten werden alle 60 Sekunden neu berechnet. Ein Abruf häufiger als dieser Takt bringt keine neuen Daten.

Erstbefüllung	einmalig `/v1/feed`, dabei über `offset` blättern, bis `hasMore` false ist
Laufender Betrieb	alle 1–5 Sekunden `/v1/feed/delta?since=<letzte seq>`
Sicherheitsnetz	alle 5–15 Minuten ein voller Abruf zum Abgleich

Der Delta-Abruf im Detail

Jede Antwort nennt einen Zählerstand seq. Schicken Sie ihn beim nächsten Mal als ?since= mit, und Sie bekommen ausschließlich, was sich seither geändert hat: changes enthält die betroffenen Spiele in genau demselben Format wie /v1/feed, removed die Spiele, die es nicht mehr gibt (Wettstopp, Spielende, Quelle ausgefallen). Ein Spiel aus removed gehört sofort aus dem Angebot.

Steht in der Antwort hasMore: true, war Ihr Rückstand größer als eine Antwort fassen soll: Sie haben ein Stück bekommen, und das mitgelieferte seq reicht nur bis zum Ende dieses Stücks. Holen Sie dann sofort mit genau diesem seq weiter, bis hasMore false ist – erst danach sind Sie auf dem aktuellen Stand. Setzen Sie Ihren Zeiger niemals auf seqEnde (das ist nur die Anzeige, wohin es insgesamt geht) – sonst überspringen Sie den Rest still.

quelleLebendig: false heißt: Wir bekommen gerade keine frischen Daten. Behandeln Sie Live-Quoten dann als veraltet und nehmen Sie keine Live-Wetten mehr an. Antwortet der Dienst mit resync: true, liegt Ihr Stand hinter unserem Änderungsjournal (eine Stunde) – dann einmal voll abrufen und mit dem neuen seq weitermachen.

Eine Quote, die 30 Minuten lang nicht erneuert wurde, verfällt; ein Spiel ohne jede gültige Quote wird nach 45 Minuten aus dem Angebot genommen. Bauen Sie Ihre Seite also so, dass ein verschwundenes Spiel ein normaler Vorgang ist.

Fehler & Grenzen

Code	Bedeutung	Was zu tun ist
200	In Ordnung	–
401	Schlüssel fehlt, ist falsch oder gesperrt	Schlüssel prüfen; im Kopf `Authorization: Bearer …` senden
403	Zugang gesperrt oder Recht fehlt	Bei uns melden – meist ist der Kundenzugang stillgelegt
404	Spiel nicht gefunden	Kennung veraltet; das Spiel ist beendet oder wurde entfernt
429	Zu viele Anfragen	Takt drosseln, kurz warten und erneut versuchen

Jeder Schlüssel hat eine Grenze pro Minute (Standard 120). Die Antwort nennt im Fehlerfall die geltende Grenze. Brauchen Sie mehr, heben wir sie für Ihren Zugang an.

{ "error": "Zu viele Anfragen (Grenze: 120/Minute)" }

Fehler kommen immer als JSON mit einem Feld error.

Kundenportal – Ihren Bezug selbst einstellen

Unter https://www.atlasoddshub.com/portal melden Sie sich mit Ihrem API-Schlüssel an und bestimmen selbst, was Ihr Feed enthält. Änderungen wirken sofort auf den nächsten Abruf – ohne Rückfrage bei uns.

Wettarten	Vorabwetten und Livewetten einzeln beziehen oder abschalten.
Marge	Eigener Aufschlag – getrennt für Vorab und Live. `1.07` = 7 % Overround; leer = Quoten unverändert.
Marktarten	Jede Marktart einzeln an- und abschalten, wieder getrennt für Vorab und Live.
Sportarten & Ligen	Abgewählte Sportarten und Ligen erscheinen gar nicht erst im Feed.
Einzelne Spiele	Einzelne Begegnungen gezielt sperren.
Abrufe	Eigener Verbrauch der letzten 30 Tage.

Dieselben Einstellungen sind auch über die API erreichbar, wenn Sie sie aus Ihrem eigenen Backoffice heraus steuern wollen:

GET  https://www.atlasoddshub.com/v1/portal/settings     # aktuelle Einstellungen
PUT  https://www.atlasoddshub.com/v1/portal/settings     # ändern (nur die gesendeten Felder)
GET  https://www.atlasoddshub.com/v1/portal/catalog      # wählbare Märkte, Sportarten, Ligen
GET  https://www.atlasoddshub.com/v1/portal/events       # Spiele mit Schalter-Zustand
GET  https://www.atlasoddshub.com/v1/portal/usage        # eigene Abrufe

# Beispiel: Live mit 8 % Marge, ohne Torschützen-Wetten
curl -X PUT https://www.atlasoddshub.com/v1/portal/settings \
  -H "Authorization: Bearer IHR_SCHLUESSEL" -H "Content-Type: application/json" \
  -d '{"marginLive":1.08,"disabledMarketsLive":["player_prop"]}'

Jeder Abruf von /v1/feed gibt unter customer.settings zurück, welche Vorgaben dabei angewendet wurden – so bleibt jede Quote nachvollziehbar.

Weitergabe der Daten

Die an Sie gelieferten Quoten sind für die Weitergabe an Ihre Endkunden freigegeben.

Die bezogenen Quoten dürfen Sie in Ihrem eigenen Angebot verwenden. Ein Weiterverkauf als eigener Datendienst ist nicht Teil des Zugangs – dafür braucht es eine gesonderte Vereinbarung.