Schema Docs

root summary

TcsRoundSummary

Type: object

Game-agnostic summary of a finished round, intended for casino management systems.

All monetary results are payout multipliers per unit bet, not currency: the system
detects bet presence, not chip denomination. Multiply by your own known bet amounts
downstream. The shape is intended to be reused across game types (Blackjack, Baccarat,
UTH), so "box" means a betting position rather than a person.

round_id
The round UUID; matches the id used on the other topics.

game_type / machine_id
Identify the source of the summary (there is no per-table id yet).

gaming_day
The gaming day (ISO date) the round belongs to; casinos bucket revenue by this.

timing
Timestamps and per-phase durations, see RoundTiming.

house_hand_value / house_outcome
The dealer/banker final total and its high-level classification (a value 17-21, BJ,
BUST, PLAYER_BUST, or UNFINISHED).

boxes
Per-box main-bet results, only for boxes that were in play.

house_result_multiplier
The house result in units this round: the sum of the negated box results.

active_boxes / total_hands
Boxes in play (before splits) and hands played (splits counted separately). These are
the ingredients for hands-per-hour, which is aggregated downstream.

side_bets
Utilization and result per configured side bet, see SideBetUtilization.

diagnostics
De-duplicated names of detected procedure or system issues; use these to flag or
exclude a round.

root summary round_id

Type: stringFormat: uuid

root summary game_type

Type: enum (of string)

Must be one of:

"Baccarat"
"Blackjack"
"Other"
"UTH"

root summary machine_id

Type: string

root summary gaming_day

Type: string

root summary timing

RoundTiming

Type: object

Timestamps and per-phase durations for a round.

All timestamps are ISO 8601 strings in the configured local timezone, or None when
the corresponding phase was never reached. When a phase occurs more than once (the
tracker can step back when cards are occluded) the first occurrence is used.

started_at
First relevant detection of the round (bet or card); the round's initialization time.

first_cards_at
Dealing begins (first card assigned).

players_turn_at
Initial deal complete; boxes begin their decisions.

dealers_turn_at
Boxes are done; the house draws.

house_finished_at
The house finished drawing.

ended_at
All cards removed from the table (payouts done).

The *_seconds fields are the durations of each phase, each None when either
bounding timestamp is missing:
betting_seconds (started -> firstcards), initial_deal_seconds
(firstcards -> playersturn), player_decision_seconds (playersturn ->
dealersturn), dealer_play_seconds (dealersturn -> housefinished),
settlement_seconds (housefinished -> ended), and total_seconds (started -> ended).

root summary timing started_at

root summary timing started_at anyOf item 0

Type: string

root summary timing started_at anyOf item 1

Type: null

root summary timing first_cards_at

Any of

Option 1
Option 2

root summary timing first_cards_at anyOf item 0

Type: string

root summary timing first_cards_at anyOf item 1

Type: null

root summary timing players_turn_at

Any of

Option 1
Option 2

root summary timing players_turn_at anyOf item 0

Type: string

root summary timing players_turn_at anyOf item 1

Type: null

root summary timing dealers_turn_at

Any of

Option 1
Option 2

root summary timing dealers_turn_at anyOf item 0

Type: string

root summary timing dealers_turn_at anyOf item 1

Type: null

root summary timing house_finished_at

Any of

Option 1
Option 2

root summary timing house_finished_at anyOf item 0

Type: string

root summary timing house_finished_at anyOf item 1

Type: null

root summary timing ended_at

Any of

Option 1
Option 2

root summary timing ended_at anyOf item 0

Type: string

root summary timing ended_at anyOf item 1

Type: null

root summary timing betting_seconds

Any of

Option 1
Option 2

root summary timing betting_seconds anyOf item 0

Type: number

root summary timing betting_seconds anyOf item 1

Type: null

root summary timing initial_deal_seconds

Any of

Option 1
Option 2

root summary timing initial_deal_seconds anyOf item 0

Type: number

root summary timing initial_deal_seconds anyOf item 1

Type: null

root summary timing player_decision_seconds

Any of

Option 1
Option 2

root summary timing player_decision_seconds anyOf item 0

Type: number

root summary timing player_decision_seconds anyOf item 1

Type: null

root summary timing dealer_play_seconds

Any of

Option 1
Option 2

root summary timing dealer_play_seconds anyOf item 0

Type: number

root summary timing dealer_play_seconds anyOf item 1

Type: null

root summary timing settlement_seconds

Any of

Option 1
Option 2

root summary timing settlement_seconds anyOf item 0

Type: number

root summary timing settlement_seconds anyOf item 1

Type: null

root summary timing total_seconds

Any of

Option 1
Option 2

root summary timing total_seconds anyOf item 0

Type: number

root summary timing total_seconds anyOf item 1

Type: null

root summary house_hand_value

Type: integer

root summary house_outcome

HouseOutcome

Type: enum (of string)

The house (dealer/banker) result for the round.

The numeric variants are the final hand value. The rest are special cases:
- BUST: the house drew over 21.
- PLAYER_BUST: the house never completed its hand because every active box had
already lost (all hands busted), so it did not need to draw.
- UNFINISHED: the house hand could not be classified (procedure or data issue,
e.g. a likely surrender). Distinct from PLAYER_BUST.

Must be one of:

"17"
"18"
"19"
"20"
"21"
"BJ"
"BUST"
"PLAYER_BUST"
"UNFINISHED"

root summary boxes

Type: array
No Additional Items

Each item of this array must be:

root summary boxes BoxRoundResult

BoxRoundResult

Type: object

Main-bet result for one active betting box.

box_index is the 0-based position, left to right. num_hands is the number of
hands played at the box (> 1 after a split). hand_values lists the final value of
each hand. hands_won / hands_lost / hands_pushed break down those hands versus
the house (their sum can be below num_hands if a hand could not be settled).

result_multiplier is the net units won or lost on the main bet across the box,
per unit bet (e.g. +1.5 for a single blackjack, -2 for a lost doubled hand).

root summary boxes BoxRoundResult box_index

Type: integer

root summary boxes BoxRoundResult num_hands

Type: integer

root summary boxes BoxRoundResult hand_values

Type: array of integer
No Additional Items

Each item of this array must be:

root summary boxes BoxRoundResult hand_values hand_values items

Type: integer

root summary boxes BoxRoundResult hands_won

Type: integer

root summary boxes BoxRoundResult hands_lost

Type: integer

root summary boxes BoxRoundResult hands_pushed

Type: integer

root summary boxes BoxRoundResult result_multiplier

Type: number

root summary house_result_multiplier

Type: number

root summary active_boxes

Type: integer

root summary total_hands

Type: integer

root summary side_bets

Type: array
No Additional Items

Each item of this array must be:

root summary side_bets SideBetUtilization

SideBetUtilization

Type: object

Utilization and result for one configured side bet across the round.

scope is "player" for per-box side bets or "layout" for table-wide ones.

opportunities counts the betting entities that could have placed this side bet: each
active box's main better plus every back better present on it (occupied back-bet
positions, de-duplicated across split stacks). A layout side bet only contributes
opportunities on rounds where the game offered it (e.g. Insurance only when the dealer
shows an Ace). played is how many of those opportunities actually placed it (capped at
opportunities to absorb misdetections).

total_payout_multiplier sums the numeric payout multipliers over the placed bets.
Progressive jackpot tiers ("GRAND" / "MAJOR" / "MINOR") are resolved by the casino's
own system and are excluded from this sum.

root summary side_bets SideBetUtilization name

Type: string

root summary side_bets SideBetUtilization scope

Type: enum (of string)

Must be one of:

"layout"
"player"

root summary side_bets SideBetUtilization opportunities

Type: integer

root summary side_bets SideBetUtilization played

Type: integer

root summary side_bets SideBetUtilization total_payout_multiplier

Type: number

root summary diagnostics

Type: array of string
No Additional Items

Each item of this array must be:

root summary diagnostics diagnostics items

Type: string

RoundSummary

summary Required

TcsRoundSummary

round_id Required

game_type Required

Must be one of:

machine_id Required

gaming_day Required

timing Required

RoundTiming

started_at Required

Any of

first_cards_at Required

Any of

players_turn_at Required

Any of

dealers_turn_at Required

Any of

house_finished_at Required

Any of

ended_at Required

Any of

betting_seconds Required

Any of

initial_deal_seconds Required

Any of

player_decision_seconds Required

Any of

dealer_play_seconds Required

Any of

settlement_seconds Required

Any of

total_seconds Required

Any of

house_hand_value Required

house_outcome Required

HouseOutcome

Must be one of:

boxes Required

Each item of this array must be:

BoxRoundResult

box_index Required

num_hands Required

hand_values Required

Each item of this array must be:

hands_won Required

hands_lost Required

hands_pushed Required

result_multiplier Required

house_result_multiplier Required

active_boxes Required

total_hands Required

side_bets Required

Each item of this array must be:

SideBetUtilization

name Required

scope Required

Must be one of:

opportunities Required

played Required

total_payout_multiplier Required

diagnostics Required

Each item of this array must be: