Currencies & languages
The API uses three currencies and two languages. Amounts travel in the session currency, as JSON numbers with two decimals.
Currencies
| Code | Symbol | Note |
|---|---|---|
| USD | $ | Default for the game list and demo |
| EUR | € | |
| TRY | ₺ |
currency is required on launch. The site’s currencies, the supported currencies of your wallet settings (Endpoints & wallet in the portal) and the game’s currencies list must include it; otherwise 422 CURRENCY_NOT_SUPPORTED. A player’s currency is fixed by their first launch on a site; the same player cannot be opened in another currency.
Amount format
- An amount is a JSON number with two decimal places: 148.60. No strings, symbols or thousands separators.
- Parse the body without loss; do not convert amounts to float. Hold balances in DECIMAL(18,2) or an equivalent.
- Callback amounts are in the session currency. The currency in an OK reply must match it; if it is missing or different, the reply counts as uncertain and an alarm is raised. balance in your reply may be a number or a number string, at most two decimals.
- A free round bet has amount 0; the spin value arrives in the freeround_bet_value field.
- The portal shows amounts in local format with the symbol on the right: 1,250.00 $. The API does not use this format.
Languages
| Code | Language |
|---|---|
| tr | Türkçe |
| en | English |
Send the game language with language on every launch; without it the game opens in Turkish (tr). The default game language setting in the portal does not change sessions opened through the API.
RTP variants
| Code | RTP |
|---|---|
| v96 | 96% |
| v94 | 94% |
| v92 | 92% |
The variants a game offers are in its rtp_variants field. How a requested variant is resolved at launch: Game launch.
Where they appear
| Field | Where | Values |
|---|---|---|
| currency | Game launch (required), Game list, GGR reports, Free rounds, all wallet calls | USD, EUR, TRY |
| language | Game launch, demo session | tr, en |
| lang | Game list | tr, en |
| rtp_variant | Game launch, Round lookup | v96, v94, v92 |