Join Round

Returns the room's open round for the caller's currency (id, status, betting close time, seed commitment) and the caller's own pending bets. Call it when entering a room, right after the event stream opens or reconnects, and whenever the client needs to resync.

Auth: Player session — Authorization: Bearer {token}
Rate limit: 300 requests per 60 s per IP (GAME_JOIN_ROUND)
Games: LOTTO

Rules

System maintenance and Lotto's own maintenance window both answer 503 99915.

status is waiting when no round is open for this room + currency (none opened yet, or a replacement round is about to open after a cancelled one). roundID and seedHash are then "" and endTime is absent. Retry later — Lotto sends no round_started.

Never returns settled or cancelled. Right after a round closes, the closing round (rolling) and the next one (betting) exist together and this call may answer either. On rolling, call again after a short delay.

endTime is RFC3339 UTC with whole seconds (e.g. 2026-09-30T11:45:30Z). No response carries server time, so the countdown runs on the client clock.

The key is roundID (capital ID). Send it back as roundID in the bet body, but as query roundId (lower-case d) on …/result.

MULTI_CSEED rooms include clientSeedSlots; keep them in sync with SSE seed_slot_updated by replacing the slot at its index.

pendingBets / pendingTotalBet restore the bet slip, but only ONE of the caller's accepted bet calls in this round is returned. A player who bet several times sees one call's items; settlement still counts every bet.

Amounts in pendingBets and pendingTotalBet are decimal strings.

The room is not checked here: an unknown roomId simply answers waiting.

The หวยเฮงเฮง screens use POST /gapi/v1/g/lotto/round for the number-entry header; this call is the shared-room view of the same round.

Flow

Resolve {gameCode} and {roomId}; the currency is the currency query, else the session currency.

THAI-HILO: load the room by number; it must exist and be active, and SINGLE-mode rooms are rejected.

Find the open round (betting or rolling) for game + room + currency in the caller's demo or real set; none gives waiting.

THAI-HILO: broadcast player_joined on the room's event stream.

Read back the caller's pending bet for that round; if it cannot be read the fields are simply omitted.

Return the round with endTime in UTC.

Request

Responses