NOCTURN SPORT

Sportsbook API pro vlastní frontend operátora

Pro týmy, které si chtějí postavit vlastní sázkové rozhraní, ale nechtějí počítat kurzy.

Aktualizováno 5. října 2026

Naše sportsbook API je určeno operátorům, kteří mají vlastní vývojáře a chtějí mít plnou kontrolu nad vzhledem a chováním sázkové části webu. Od nás dostanou kurzy, strukturu nabídky a zpracování sázek; prezentační vrstvu si postaví sami. Pokud hotový frontend potřebujete, podívejte se na stránku white label sportsbook.

Feed nabídky: snapshot a verzované změny

Klient si nejprve stáhne úplný snapshot – všechny sporty, turnaje, zápasy, trhy a výsledky s aktuálními kurzy. Každý stav nese číslo verze. Následně klient přibližně každých deset sekund pošle dotaz se svou poslední verzí a server mu vrátí jen to, co se od té doby změnilo: nové zápasy, upravené kurzy, pozastavené nebo uzavřené trhy. Tento přístup šetří přenos dat a zjednodušuje synchronizaci, protože klient vždy přesně ví, ze kterého stavu vychází. Strukturu dat podrobněji popisujeme na stránce odds feed.

Přijímání sázek

  • Sólo sázky a AKO tikety až s deseti výběry, maximálně jeden výběr z jedné události.
  • Request ID u každého požadavku – opakované odeslání téhož tiketu (například při výpadku spojení) nevytvoří duplicitní sázku.
  • Kontrola limitů – minimální a maximální kurz, nejvyšší vklad a výplata, počet výběrů a uzávěrka před začátkem zápasu.

Pokud kurz mezi zobrazením a odesláním tiketu změnil hodnotu nebo byl trh pozastaven, server sázku nepřijme za starou cenu a frontend může hráči nabídnout aktuální kurz k potvrzení.

Historie a zůstatek

API vrací historii sázek hráče se stavem každého tiketu (otevřený, výherní, prohraný, vrácený) a zůstatek hráče. Operátor tak může hráčům zobrazit přehled tiketů ve vlastním rozhraní a jeho podpora má k dispozici stejná data jako systém.

Typický průběh integrace

  1. Klient načte snapshot a uloží si číslo verze.
  2. V pravidelném cyklu žádá o rozdíly a aplikuje je na svou lokální kopii nabídky.
  3. Hráč na webu operátora sestaví tiket; frontend ho odešle s jedinečným request ID.
  4. Server ověří limity a aktuální kurzy, sázku přijme nebo odmítne s důvodem.
  5. Po skončení zápasu se tiket vyhodnotí a změna se projeví v historii i v zůstatku hráče.

Díky verzování nemusí klient nikdy porovnávat celou nabídku. Když se spojení na delší dobu přeruší, stačí znovu stáhnout snapshot a pokračovat od nové verze.

Back office nad API

I když stavíte vlastní frontend, správa rizika zůstává v našem back office: pozastavení zápasu, ruční změna kurzu, vyhodnocení výsledků, přehled o otevřených závazcích, nastavení marže a všech limitů. Změny se do feedu propisují jako další verze, takže je klient zachytí při nejbližším dotazu.

Integrace a další krok

Technické napojení probíhá přes SoftAggregator; kdo už u něj má kasinové hry, přidá sportsbook bez nové smlouvy s dalším dodavatelem. Technickou dokumentaci předáme po úvodní domluvě. Ceny jsou individuální, na vyžádání. Technické otázky směřujte na [email protected], rychlou odpověď získáte i přes Telegram @mentionso; další možnosti jsou na stránce kontakt. Přehled celé nabídky najdete pod sportsbook software.

Časté otázky

Jak často se má feed dotazovat?

Doporučený interval je zhruba deset sekund. Klient posílá číslo poslední verze a dostává jen rozdíly.

Co se stane, když tiket odešlu dvakrát?

Každý požadavek nese request ID. Pokud dorazí podruhé se stejným ID, systém ho nezpracuje jako novou sázku.

Podporuje API kombinované sázky?

Ano, AKO tikety až s deseti výběry, každý z jiné události. Operátor může maximální počet výběrů snížit.

Jsou k dispozici live kurzy přes API?

Momentálně ne, feed obsahuje předzápasovou nabídku. Sázky během zápasu připravujeme.

Další stránky na webu