OddsHub – Anbindung

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://staging.atlasoddshub.com

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

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

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

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

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://staging.atlasoddshub.com/v1/feed?apiKey=ohk_xxxxxxxxxxxxxxxxxxxxxxxx

Rechte

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

Parameter von /v1/feed und /v1/events

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

Felder eines Marktes

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.

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.

Abruftakt

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

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

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://staging.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.

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

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

# Beispiel: Live mit 8 % Marge, ohne Torschützen-Wetten
curl -X PUT https://staging.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.