Create Ticket

Confirms the whole basket as one ticket with one debit, and returns the ticket id, the new balance and each line's settle rate and potential win. Idempotent per requestId.

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

Rules

Lotto only: the route is under /g/lotto, so system maintenance and Lotto's own maintenance window both answer 503 99915.

Body keys are requestId, roomId, roundId (lower-case d); the returned ticket id is betID (capital ID).

requestId is a client-generated idempotency key, unique per player (not per round). After a timeout or a dropped connection, resend the SAME requestId to get the same ticket back with no second debit. Use a new one for every new ticket: an old one returns the old ticket (200) and places nothing, even in a later round or with a different body.

A replay does not re-check the body. The replayed balance is the balance at the original debit, and rate / isLucky / potentialWin are recomputed from the current lucky number, so after the round settles they can differ from the first response.

409 99964 means another request with the same requestId is in progress; retry with the same requestId to receive that ticket.

1-20 items; no two items with the same betType + number (exact strings: 3-TOAD "917" and "179" are different; 3-BOTTOM "917" plus 3-TOAD "917" is allowed).

All-or-nothing: items are checked in order (the first failure is reported) before any debit, then the total is debited once.

Each item needs amount > 0 and ≥ the room minimum (limits.minPerItem). The round-wide total on one bet type + number across all players must stay ≤ limits.maxPerNumber (equal is allowed).

Amounts are JSON numbers (a numeric string is also accepted), decimals allowed. In the response totalAmount, amount and potentialWin are JSON numbers but balance is a decimal string.

potentialWin = amount × rate truncated to 2 decimals (gross, stake included). isLucky is true only for 2-BOTTOM lines on the current lucky number, and their rate includes the lucky multiplier.

If the round closes while the ticket is being placed, the debit is refunded and the call answers 400 99942.

createdAt: a fresh create returns the server's local time offset with nanoseconds; a replay returns UTC with milliseconds. Parse it as a date.

Validation failures answer 400 99911 with a description listing the fields, e.g. requestId is required; betType is required.

Flow

Validate the body; reject more than 20 items or a duplicate bet type + number.

If this player already has a ticket with this requestId, return it (no new debit).

Check the round (exists, this room, session currency, still betting), the game's availability and the room.

Check every item in order: amount > 0, bet type and number format, a positive rate in the round's payout table, room minimum, then the round-wide per-number cap.

Debit the ticket total once from the player's wallet.

MULTI_CSEED rounds: claim the first free client-seed slot and broadcast SSE seed_slot_updated; a failed claim never fails the ticket.

Store the ticket (status WAITING) and re-check the round; if it closed meanwhile, refund and reject.

Return the ticket with per-line rates and potential wins.

Request

Responses