Available Games

Game endpoints are authenticated via session token (Bearer token in the Authorization header). The session is created by the operator via POST /operator/launch.

Games

Dice

Roll a target number — win if the outcome is over or under your chosen threshold. Configurable risk with a sliding target.

Limbo

Pick a target multiplier — win if the generated multiplier exceeds your target. Higher targets mean higher risk and reward.

Plinko

Drop a ball through a pyramid of pegs. Choose rows (8–16) and risk level (low, medium, high). The ball lands in a slot with a corresponding multiplier.

Keno

Select up to 10 numbers from a 40-number grid. The RGS draws 10 random numbers. Payouts scale with how many picks are hit.

Mines

Reveal tiles on a 5×5 grid while avoiding hidden mines. Choose 1–24 mines. Each safe reveal increases your multiplier — cash out anytime.

RTP Variations

Each game is registered at multiple Return to Player (RTP) percentages: 99%, 98%, and 96%. The game code uses a mnemonic suffix derived from the house edge:

Game	99% RTP	98% RTP	96% RTP
Dice	`dice-alpha`	`dice-beta`	`dice-delta`
Limbo	`limbo-alpha`	`limbo-beta`	`limbo-delta`
Plinko	`plinko-alpha`	`plinko-beta`	`plinko-delta`
Keno	`keno-alpha`	`keno-beta`	`keno-delta`
Mines	`mines-alpha`	`mines-beta`	`mines-delta`

The operator selects the RTP variation when launching a session via the gameCode field.

Game Messages

Bet and verify requests include a message field containing game-specific parameters encoded as JSON. The exact schema varies per game — refer to the request/response schemas in the API Reference.

Mines: Multi-Action Flow

Mines is a multi-action game where a single round consists of multiple requests:

sequenceDiagram
    participant Player as Game Client
    participant RGS as RGS API
    participant Op as Operator Wallet

    Player->>RGS: POST /game/play (action: start, mines: 5)
    RGS->>Op: POST /callback/debit
    Op-->>RGS: { balance }
    RGS-->>Player: { grid state, multiplier: 1.0x }

    Player->>RGS: POST /game/play (action: reveal, field: 7)
    RGS-->>Player: { safe! multiplier: 1.25x }

    Player->>RGS: POST /game/play (action: reveal, field: 12)
    RGS-->>Player: { safe! multiplier: 1.56x }

    alt Player cashes out
        Player->>RGS: POST /game/play (action: cashout)
        RGS->>Op: POST /callback/credit (roundClosed: true)
        Op-->>RGS: { balance }
        RGS-->>Player: { payout, mine positions revealed }
    else Player hits a mine
        Player->>RGS: POST /game/play (action: reveal, field: 3)
        RGS->>Op: POST /callback/credit (amount: 0, roundClosed: true)
        RGS-->>Player: { mine hit! all positions revealed }
    end

Sessions

Provably Fair