# Thrillzz Jackpots — Developer Portal

> Reference documentation for integrating Jackpots into an operator lobby or game. **Current** covers what is integrable today: live jackpot values (Ticker API `GET /v2/counters`) and recent wins plus period win totals (Win History API `GET /api/v3/WinHistory/recent|summary`, scoped by `ProductId` + `ModuleId` + `ClientId` — the product-only routes are specified but not deployed). **Future** adds lobby opt-in (Player Context), the Jackpots Widget and server-side opt-in wagering (Gameplay API).

Start with the full document below; it contains every endpoint with parameters, schemas and examples, the environment hosts, and the feed rules that break naive integrations (units, ids, must-be-won ceilings).

Editions:
- **Current** — Available today — live jackpot values and win history for a lobby. Services: ticker, win-history.
- **Future** — Coming next — lobby opt-in, the Widget and server-side opt-in wagering. Services: gameplay, ticker, win-history, player-context.

Read these before writing code:
- `GET /v2/counters` values `startAtValue` / `endAtValue` are **currency units** (e.g. `13842.74` EUR). `centsPerSecond` and every Win History `*Cents` field are **cents**. Never divide counters values by 100.
- `endAtValue` is the next animation checkpoint (reached after `numberOfSeconds`), **not a cap**. Animate from `startAtValue` at `centsPerSecond / 100` per second and clamp at `endAtValue`, then re-poll.
- `jackpotType` is an integer, and it is per level and set by configuration — read it per row rather than assuming it from the level's name. `2` = must be won: show progress toward the ceiling `jackpotMaxAmountCents / 100`. Any other type (e.g. `3`, which Jackpot Madness's Madness level returns) has no ceiling and its `jackpotMaxAmountCents` is a sentinel (live: ~1.17e10) — never show a ceiling for those. Live on 2026-09-16, one Jackpot Madness game returned Madness as `3` and Mayhem, Mania and all three Mystery levels as `2`; the Mystery levels reported `3` the day before, so branch on the value you are handed.
- Win History composes `progressiveId` from the site id and the level id, so it equals the ticker's raw level id (live range ~20047–20213) only while the site id is zero — what production returns for the live series today (verified 2026-09-15). Do not build on the ids matching: label wins by `levelIndex` (0-based), which is the ticker's `gamePayId`.
- The version is a literal path segment and `counters` is **v2 only** — `GET /v1/counters` returns `404`. v1 exposes `GET /v1/ticker` instead (different parameters, different shape). Paths in this document are callable as written; do not substitute a version into them.
- Both feeds answer `GET /health` with `200 Healthy`, unauthenticated and parameterless — use it to confirm reachability before debugging a call.

## Docs
- [Full documentation, single file](https://docs.jackpots-platform.io/llms-full.txt): editions, hosts, auth, feed rules, every endpoint and schema, the reference widget.
- [Developer portal (HTML)](https://docs.jackpots-platform.io/): the same content for humans, with a Current / Future toggle and a live widget demo.

## OpenAPI
- [ticker.v1.json](https://docs.jackpots-platform.io/openapi/ticker.v1.json)
- [ticker.v2.json](https://docs.jackpots-platform.io/openapi/ticker.v2.json)
- [win-history.v2.json](https://docs.jackpots-platform.io/openapi/win-history.v2.json)
- [win-history.v3.json](https://docs.jackpots-platform.io/openapi/win-history.v3.json)
- [player-context.v1.json](https://docs.jackpots-platform.io/openapi/player-context.v1.json)
- [gameplay.v1.json](https://docs.jackpots-platform.io/openapi/gameplay.v1.json)
- [gameplay.v2.json](https://docs.jackpots-platform.io/openapi/gameplay.v2.json)
- [gameplay.v3.json](https://docs.jackpots-platform.io/openapi/gameplay.v3.json)

## Reference widget source
- [React (TypeScript) — served as .txt, save as lobbyWidget.tsx](https://docs.jackpots-platform.io/examples/lobbyWidget.tsx.txt)
- [Plain JavaScript (ES module)](https://docs.jackpots-platform.io/examples/lobbyWidget.js)
- [Vue 3 single-file component (pairs with lobbyWidget.js)](https://docs.jackpots-platform.io/examples/LobbyWidget.vue)

## Optional
- [Bridge hosts — Staging](https://jackpotbridgeticker29.gameassists.co.uk): ticker; win history at https://jackpotwinhistory29.gameassists.co.uk.
- [Bridge hosts — Production](https://jackpotbridgeticker.gameassists.co.uk): ticker; win history at https://jackpotwinhistory.gameassists.co.uk.
- Support: ThrillzzJackpots@gamesglobal.com