Get Balance

Returns a fresh balance for the player in the given game. FE calls it to refresh the balance, e.g. after a bet or a settlement.

Auth: Player session — Authorization: Bearer {token}
Rate limit: 300 requests per 60 s per IP (GAME_BALANCE)
Games: THAI-HILO, LOTTO

Rules

Same response and same checks as GET /c/g/{gameCode}/check-session.

The balance is always read live, never from a cache: when it cannot be read the call answers an error rather than a last known value.

balance is a decimal string; a negative balance is returned as "0.00".

A game-launch token is bound to its game: another gameCode answers 403 99903. Demo tokens work with any game.

Blocked by both system-wide and this game's own maintenance (503 99915).

Has its own rate-limit bucket (GAME_BALANCE), so polling here does not use up the check-session limit.

For seamless-wallet players each call asks the operator's wallet live; allow a generous timeout.

Flow

Validates the token and checks system and per-game maintenance.

Resolves gameCode and rejects a game-launch token opened for a different game.

Reads a fresh balance for the player's wallet type (demo, transfer or seamless).

Returns a negative balance as "0.00" and returns the same fields as check-session.

curl --location 'https://dev-api.ambfairgame.com/gapi/v1/gapi/v1/c/g/THAI-HILO/balance' \ --header 'Authorization: Bearer 3f9a1c7e5b2d4f6081a3c5e7f9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7' \ --header 'Accept-Language: th'

{ "code": "0", "description": "Success.", "traceID": "0f8e2c1a-6b3d-4e5f-9a7b-1c2d3e4f5a6b", "data": { "id": 9123456789, "playerName": "Demo Tester", "balance": "9950.5", "currency": "THB", "symbolCurrency": "฿", "isDemo": true, "gameCode": "THAI-HILO", "language": "" } }

Request

Responses