JRGS Casino API
ReferenceLaunch API

List a market's games

The casino calls GET /catalog/games on the launch API, with a key that holds the catalog scope.

GET/catalog/games

The games of one of the casino's markets, in id order, one page at a time. Follow nextCursor until it is absent. A page can hold fewer than limit items, none even, and still have a nextCursor: a game without published math is left out after the page is cut.

The answer carries an ETag, a hash of the body, the same on every replica. Send it back in If-None-Match to get 304 with no body when nothing changed. The request must still be signed.

Today every listed game has status active. A suspended game (the game, its variant, the market or the casino stopped by the kill switch) is left out until the stop ends. A game configured without catalog details is listed under its id as title, with an empty type and thumbnail, the market's bet grid, and updatedAt 0001-01-01T00:00:00Z. rtpPpm is 0 for a game whose math this RGS does not run itself.

freeRounds is present on a game that may be awarded free rounds: the market allows them and the game's release supports them. It holds what POST /free-rounds accepts for the game.

Query Parameters

market*string

The market id.

limit?integer

Page size.

Range1 <= value <= 200
Default200
cursor?string

nextCursor of the previous page. Opaque.

Header Parameters

If-None-Match?string

ETags of a previous answer, comma-separated, or *. Compared weakly.

X-Key-Id*string

The id of the signing key, as issued with it.

X-Timestamp*string

Unix seconds, within 60 s of the RGS clock. The first line of the signed payload.

Match^-?[0-9]+$
X-Signature*string

Base64 (standard, padded) Ed25519 signature of "{X-Timestamp}\n{METHOD}\n{path?query}\n{hex(sha256(body))}".

Formatbyte
X-Request-Id?string

Echoed as requestId in an error. One is generated when absent. On POST /sessions the body's requestId replaces it once the body has been read and signed.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/catalog/games?market=string" \  -H "X-Key-Id: string" \  -H "X-Timestamp: 1793707200" \  -H "X-Signature: string"
{  "items": [    {      "id": "slots",      "title": "Slots",      "type": "slot",      "status": "active",      "variant": "957",      "rtpPpm": 957000,      "maxWinMultiplier": 5000,      "features": [        "free_spins",        "multipliers"      ],      "bets": {        "GBP": {          "min": 200000,          "max": 2000000,          "default": 1000000        }      },      "media": {        "thumbnail": "https://cdn.example.com/media/slots.svg"      },      "build": "1.0.0",      "updatedAt": "2026-11-01T00:00:00Z"    }  ]}