Room Event Stream

Opens a Server-Sent Events stream of real-time room events (new round, bets, client-seed slots, settlement) for one room + currency. Open it with EventSource when the player enters a room.

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

Rules

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

See Getting Started → Real-time Events for the frame format, every event and the reconnect playbook.

EventSource cannot send headers: pass the session token as ?token= (URL-encoded).

Frames are data: {"type":…,"data":…} only; handle them in onmessage and switch on .type.

Nothing is replayed on connect: call Join Round (GET …/round) right after the stream opens and after every reconnect.

An error before streaming starts is a normal JSON error response with a non-200 status; EventSource treats it as fatal and stops retrying, so create a new EventSource.

60 connects per 60 s per client IP; every reconnect counts.

The room is not checked: any integer roomId opens a stream, which stays silent if the room does not exist.

One stream per room + currency (+ demo/real). To switch room or currency, close it and open a new one.

The session is checked only at connect; an open stream keeps delivering after the token expires.

Flow

Authenticate from the Authorization header or ?token=; resolve {gameCode}, {roomId} and the currency (query, else session).

Subscribe to the room channel for game + room + currency + demo/real; a failure answers a JSON 500.

Send the SSE headers and forward each room event as one data: frame; round_settled carries only this player's playerResult.

Keep streaming until the client disconnects; there is no server-side time limit and no heartbeat.

curl --location 'https://dev-api.ambfairgame.com/gapi/v1/gapi/v1/g/lotto/rooms/1/stream?token=tok_synthetic_7f3a9c&currency=THB' \ --header 'Authorization: Bearer 3f9a1c7e5b2d4f6081a3c5e7f9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7' \ --header 'Accept-Language: th'

{ "type": "round_started", "data": { "roundID": "tbq1x0a7c3e91f2", "endTime": "2026-09-30T18:45:30.123456789+07:00", "seedHash": "9f2c1e7a5b3d8f40c6a1e2d9b7f35c08e4a6d1b9c2f7e3a05d8b6c4e1f2a9d37" } }

Request

Responses