1. Lotto (หวยเฮงเฮง)
[Game] FairPlay API
  • Getting Started
    • Introduction
    • Session and Token
    • Request and Response
    • Real-time Events (SSE)
    • Lotto Rules — หวยเฮงเฮง
    • Provably Fair
  • Player
    • Demo
      • Demo Login
    • Player Bet History
      GET
  • Common
    • Game
      • By Game Code
        • Provably Fair
          • Set Client Seed
          • Verify Result
          • Get Revealed Server Seed
        • Check Session
        • Get Balance
        • Get Provably-Fair State
      • Lobby Game List
  • Wallet
    • Wallet Status
      GET
  • Game
    • Lotto (หวยเฮงเฮง)
      • Lotto Rules
      • Rooms
        • By Room
          • Join Round
          • Place Multi-player Bet
          • Get Round Result
          • Room Event Stream
      • Tickets
        • Create Ticket
        • Inquiry My Tickets
        • Get Ticket
      • Round
        • Get My Bets
        • Get My Result
        • Get Round Provably Fair
      • Results
        • Inquiry Results
      • Get Rooms
        GET
      • Get Current Round
        POST
      • Get Pay Table
        GET
  • Appendix
    • Game List
    • Error Codes
    • Rate Limits
  • Language List
    GET
  • Ping
    GET
  • Schemas
    • DemoLoginRequest
    • DemoLoginResponse
    • DemoProfileResponse
    • ProfileResponse
    • GetHistoryResponse
    • BetRecord
    • GameInfo
    • Room
    • GetGameResponse
    • BetRequest
    • Bet
    • BetResponse
    • BetResult
    • GetProvablyFairResponse
    • SetClientSeedRequest
    • SetClientSeedResponse
    • RotateServerSeedResponse
    • VerifyResultRequest
    • VerifyResultResponse
    • GetServerSeedResponse
    • GetStatusResponse
    • JoinRoundResponse
    • PlaceMultiPlayerBetRequest
    • PlaceBetResponse
    • RoundResultResponse
    • SuccessResponse
    • ErrorResponse
  1. Lotto (หวยเฮงเฮง)

Get Current Round

POST
/gapi/v1/g/lotto/round
Returns the header of the number-entry screen for a room: the open round with its close time and seed commitment, the lucky number and the last two results. Call it after the player picks a room and again when a round closes.
Auth: Player session — Authorization: Bearer {token}
Rate limit: 300 requests per 60 s per IP (LOTTO_GET_ROUND)
Games: LOTTO
Rules
Lotto only: the route is under /g/lotto, so system maintenance and Lotto's own maintenance window both answer 503 99915.
POST with a JSON body even though it is a read.
Body key is roomId (lower-case d), the room number from GET …/rooms.
Validation failures answer 400 99911 with the generic description "Bad request."; unlike the other LOTTO POST endpoints, the field is not named.
round is null when no round is open yet; poll again. Its roundId (lower-case d) is what tickets/create, my-bets, my-result and provably-fair take.
drawAt always equals closeAt: the draw happens as soon as betting closes.
lucky is null when the feature is off or no round has settled yet.
recentResults holds up to the 2 latest settled numbers, newest first, and is always an array ([] when none); it is filled even when the lucky feature is off.
The room must serve the session currency (99955).
LOTTO sends no round_started event: call this again after SSE round_settled or once closeAt passes to get the next round.
Flow
1.
Accept LOTTO only; validate roomId; check the session game.
2.
Check the game is available; load the room (must exist and be active) and check it serves the session currency.
3.
Add the open round for room + currency, or null.
4.
Add the last 2 settled numbers, and the lucky number when the feature is on.

Request

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠429Too Many Requests
🔴500Internal Server Error
🔴503Service Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://dev-api.ambfairgame.com/gapi/v1/gapi/v1/g/lotto/round?token=8d0c6a4e2b9f4f1c9a7e3b5d1c2e4f60' \
--header 'Authorization: Bearer 3f9a1c7e5b2d4f6081a3c5e7f9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7' \
--header 'Accept-Language: th' \
--header 'Content-Type: application/json' \
--data '{
    "roomId": 1
}'
Response Response Example
200 - Round open
Betting is open and the lucky feature is on.
{
    "code": "0",
    "description": "Success.",
    "traceID": "0f8e2c1a-6b3d-4e5f-9a7b-1c2d3e4f5a6b",
    "data": {
        "room": {
            "roomId": 1,
            "name": "ห้องหวย 1"
        },
        "round": {
            "roundId": "tm64903fa91c2e",
            "status": "betting",
            "closeAt": "2026-09-30T08:15:00Z",
            "drawAt": "2026-09-30T08:15:00Z",
            "serverSeedHash": "3f04d98ae3617254171fd4f378882f775947d5e8b5218b6978401d5e832b5d1a"
        },
        "lucky": {
            "number": "17",
            "multiplier": 4,
            "rate": 360
        },
        "recentResults": [
            {
                "number": "482917"
            },
            {
                "number": "055217"
            }
        ]
    }
}
Modified at 2026-09-30 13:23:45
Previous
Get Rooms
Next
Get Pay Table
Built with