Skip to content
Developer Hub

Open app

Get valid free-round stakes for a game

GET
/games/{game_id}/stakes

The valid stakes you may use to issue free rounds on this game in a given currency (POST /v1/free-rounds). Stakes are per game, per currency. Branch on mode, not on provider:

  • enumerated - we hold the valid-stake list. Each entry carries an amount (and a coin_level when stake_field is coin_level); the operator picks one and sends it via stake_field. (TrueLabs always; Apparat for a currency we hold a bet-step ladder for, e.g. EUR.)
  • provider_validated - we have no list; submit a bet_amount and the provider validates it at issue time. stakes is empty. (Apparat for a currency with no ladder on file.)
  • unsupported - the provider exposes no free-round stake model.

Mobule answers unsupported with stake_field: null: we hold no Mobule stake ladder and the provider does not validate the stake at issue time. Issue with bet_amount plus provider_params.betlevel/rate as described under POST /v1/free-rounds.

Mobule requires current support approval for the exact organization bound to the authenticated operator key. Unbound keys cannot infer an organization. A platform key takes no sub_operator_ref here and is evaluated as the platform account, admitted by its organization’s approval. Discovery omits unapproved games (direct game/stakes lookup returns 404). Launches and launcher re-reads return PROVIDER_ACCESS_REQUIRED (403) on denial; storage uncertainty returns PROVIDER_ACCESS_UNAVAILABLE (503). Requests for other providers keep their existing access policy.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
game_id
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
currency
required
string
>= 3 characters <= 10 characters

ISO-4217 currency the stakes are quoted in (e.g. EUR). Stakes are per-currency.

Responses

Section titled “Responses”

200

Section titled “200”

Valid free-round stakes for the game in the requested currency.

object
game_id
required
string format: uuid
provider_code
required
string
truelabs
currency
required
string
EUR
stake_field
required

Which field to send to POST /v1/free-rounds for this game. coin_level - pick a stakes entry and send its coin_level (e.g. TrueLabs). bet_amount - send a money amount; when stakes is non-empty pick one of its amount values, otherwise send any valid amount (e.g. Apparat). null for unsupported.

string
nullable
Allowed values: coin_level bet_amount
mode
required

enumerated - stakes lists the valid stakes; pick one and send it via stake_field. provider_validated - stakes is empty, send a bet_amount the provider validates at issue time. unsupported - the provider has no free-round stake model.

string
Allowed values: enumerated provider_validated unsupported
stakes
required

For enumerated, the valid stakes (pick one). Empty for the other modes.

Array<object>
object
coin_level

1-based level to send as coin_level. Present only when stake_field is coin_level.

integer
amount
required

The money stake, in currency. Send it as bet_amount when stake_field is bet_amount.

number

400

Section titled “400”

Invalid game_id or missing/invalid currency.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

401

Section titled “401”

Missing, invalid, or revoked API key.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

404

Section titled “404”

No game found with that ID.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

502

Section titled “502”

Stakes temporarily unavailable (the provider stakes source was unreachable). Retry.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

503

Section titled “503”

Provider access or session authorization storage is temporarily unavailable.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any