Game actions

These endpoints are called by the game launcher in the player's browser, with the short-lived token from the launch URL — not by your server. They are documented because you will see the resulting rounds and transactions, and because some operators build their own front end.

Session state#

Everything a client needs to render: the session, the player's balance as your wallet last reported it, the stake limits, and the current fairness commitment.

The generic action endpoint#

Every single-player game is driven through one endpoint. Adding a game does not add an endpoint — the action name and body are defined by the game's own contract, which is why our catalogue can grow without your client changing.

Mines#

Start a round

{
  "round_id": "rnd_7c31ea",
  "state": "ACTIVE",
  "revealed": [],
  "multiplier": "1.00",
  "balance": "489.50"
}

Pick a tile

A safe tile raises the multiplier. A mine ends the round at zero and reveals the whole grid, so the player can verify the layout against the seed.

Cash out

Settles at the current multiplier and credits the win through your wallet. Cashing out with nothing revealed is refused.

Magic Ball#

At least one cup must carry a chip, and no more than maxSpots of them (two by default) — covering all three would be a stake that cannot lose, which is not a game.

Spin da’ Bottle#

Under Over 7#

Two dice, settled immediately. The response carries both dice, their total, the outcome that total fell into, and the multiplier the chosen call pays.

{
  "round_id": "rnd_8q2v…",
  "dice": [3, 4],
  "total": 7,
  "outcome": "seven",
  "pick": "seven",
  "multiplier": "5.82",
  "status": "won",
  "stake": "1.00",
  "payout": "5.82"
}

Dice#

A number in 0.00–99.99 is drawn and you win if it comes in strictly under your target, settled immediately. The response carries the roll, the target, the multiplier that target pays and its win_chance.

{
  "round_id": "rnd_3k9m…",
  "roll": "42.17",
  "target": 50,
  "multiplier": "1.94",
  "win_chance": "50%",
  "status": "won",
  "stake": "1.00",
  "payout": "1.94"
}

Lucky Wheel#

Sixteen faces, one draw, settled immediately. The response carries the segment that came up, its multiplier, and the angle the rim stopped at — the last only so a client can animate to the answer the server already gave.

{
  "round_id": "rnd_ipskzzin6dxe2f5vmr6k",
  "segment": 7,
  "multiplier": "0.6",
  "angle": "168.7500",
  "status": "won",
  "stake": "2.00",
  "payout": "1.20",
  "server_seed_hash": "2040c88d…",
  "nonce": "1"
}

Twin Wheels#

Two wheels of twenty-five faces each stop on one face apiece, and the pair settles to one multiplier: a match pays itself, a Wild becomes the other wheel's multiplier, two different multipliers pay x2, and two Wilds re-spin free with every bet still riding. The stake on the multiplier that lands is paid at that multiplier; the others are lost.

spins lists every spin the round took — more than one only when Wilds re-spun — as face indexes on each rim, so a client can animate each in turn. outcome is the multiplier that settled.

{
  "round_id": "rnd_4w8cqk2j0hz1n7yd5ex3",
  "spins": [
    { "a": 0, "b": 0, "face_a": "W", "face_b": "W" },
    { "a": 3, "b": 0, "face_a": "15", "face_b": "W" }
  ],
  "free_spins": 1,
  "outcome": "15",
  "multiplier": "15",
  "status": "won",
  "stake": "2.00",
  "payout": "15.00",
  "server_seed_hash": "9d1f30a2…",
  "nonce": "4"
}

Prize Drum#

A drum of fifty equal sectors. A colour sector pays the stake on that colour at its multiple; a free-spin sector grants four spins, two, or one (a respin), played straight away with the same bets at no cost — and they can grant more. spins lists every spin of the round in order, each with the sector it landed on, its face ("40"…"2", "F4", "F2" or "R") and what it payout; the round's payout is their sum.

{
  "round_id": "rnd_t0m8a3zq6c1v4h7n2wxe",
  "spins": [
    { "sector": 34, "face": "F2", "payout": "0" },
    { "sector": 8, "face": "10", "payout": "10" },
    { "sector": 4, "face": "40", "payout": "40" }
  ],
  "free_spins": 2,
  "status": "won",
  "stake": "2.00",
  "payout": "50.00",
  "server_seed_hash": "4e2b77c0…",
  "nonce": "9"
}

Gem Rush#

Three actions on one round, the way Mines has them. dig opens it and takes the stake. A dig that pays nothing settles there; one that pays keeps the round open with the win on the table, until collect pays it or gamble doubles or loses it. Your wallet sees one debit and, at most, one credit — the gamble is not a chain of rounds.

Dig

The rock gives up one gem — or, one dig in twenty, TNT (tnt: true) gives three, four or five, each drawn independently. finds lists them in order, each with its gem, the multiplier drawn from that gem's own list, and its payout: the stake on that gem times the multiplier. win is their sum. status is "lost" (settled, nothing found that was backed), "won" (open, the win is on the table) or "collected" (settled at once, because the release has the gamble off or the win cannot be doubled under the maximum win). can_gamble says whether a call is allowed.

{
  "round_id": "rnd_g3m5r8u2s4h6x1k9q7wz",
  "tnt": true,
  "finds": [
    { "gem": "ruby", "multiplier": 10, "payout": "10.00" },
    { "gem": "emerald", "multiplier": 3, "payout": "3.00" },
    { "gem": "amber", "multiplier": 3, "payout": "0.00" }
  ],
  "win": "13.00",
  "steps": 0,
  "can_gamble": true,
  "status": "won",
  "stake": "2.00",
  "settled": false,
  "server_seed_hash": "b71e09d4…",
  "nonce": "12"
}

Gamble

A number from 1 to 14 is drawn. Right doubles win and the round stays open; wrong settles it at nothing. The response carries the number, whether the call was correct, and the new win, steps and can_gamble. A win may be doubled up to gambleSteps times (five by default) and never past the maximum win; past either, a call is refused and the win must be collected.

Collect

Settles the round at win and credits it through your wallet. A win left on the table is not lost: the round stays open, GET /v1/game/state returns it under round.state, and the launcher offers the same choice when the player comes back.

Prism Sevens#

Three reels, three rows, five lines — the rows and the two diagonals. A line pays for three sevens of one colour; a window full of gold, red or green sevens also pays the Grand (1000×), Major (100×) or Mini (25×) jackpot as jackpot. scatters counts the scatters in view: three start ten free spins, which come back played, in order, as free_spins — each with its own grid, lines, jackpot and win. Three scatters during them add ten more, up to a hundred. payout is the spin and every free spin together.

Big Top Coins#

A five-line slot with a hold-and-win coin bonus, and two ways to play beyond a plain spin. Both actions settle at once: the whole bonus is played out by the engine and returned for the client to show.

Spin

grid shows the five reels, lines what paid (in stakes), and coins the coins in view with their values. With the Clown and two or more coins in view, bonus carries the bonus: the start coins by place (0–11 across reels 1, 2, 4 and 5), every respin with what landed, which cash coins a Lucky Clown multiplied and by how much, and how many respins were left; then the total in stakes and the win. The round's stake is what the spin cost.

Buy the bonus

Starts the bonus at once, with two, three or four coins in the proportions a natural trigger has (486 : 36 : 1). Free bets cannot buy it.

Chilli Sevens#

A five-reel, twenty-line fruit machine, settled immediately. stops is where each reel stopped (the index of the symbol in its top row) and grid the five columns of three symbols that shows. lines lists every paying line — its number, the symbol, how many in a row, and what it pays in line stakes. stars counts scatters anywhere. chillies are the three chilli reels (0 blank, otherwise how many chillies); three of the same make multiplier 3, 6 or 9, applied to the line and star wins in spin_win.

One spin in 500 carries jackpot: its kind (mini, minor, major, mega or grand), what it pays as a multiple of the stake, the win, and crystals — the order the crystal board reveals, ending on the third of the winning kind. The jackpot is decided when the spin is played; a client reveals the sequence, and never lets a pick choose it. payout is spin_win plus the jackpot.

{
  "round_id": "rnd_c7h1l2s3e4v5n6r7t8y9",
  "stops": [12, 4, 27, 9, 18],
  "grid": [["cherry", "plum", "seven"], ["cherry", "orange", "lemon"], ["cherry", "grape", "melon"],
           ["star", "melon", "plum"], ["lemon", "orange", "grape"]],
  "lines": [{ "line": 2, "symbol": "cherry", "count": 3, "pays": 6 }],
  "stars": 1,
  "chillies": [2, 2, 2],
  "multiplier": 6,
  "spin_win": "1.80",
  "jackpot": null,
  "status": "won",
  "stake": "1.00",
  "payout": "1.80",
  "server_seed_hash": "e0a4c91b…",
  "nonce": "31"
}

Nova Drop#

A ball falls through a triangle of pegs into the slots below it, settled immediately. The response carries the slot it landed in, that slot’s multiplier, the rows and risk the round was played at, and — unlike every other game here — the whole path.

{
  "round_id": "rnd_e5jfco5u72zkwkosvpmn",
  "path": "RRRRLRLR",
  "slot": 6,
  "rows": 8,
  "risk": "medium",
  "multiplier": "1.01",
  "balls": [
    { "path": "RRRRLRLR", "slot": 6, "multiplier": "1.01", "payout": "1.01" },
    { "path": "LRRLRRRL", "slot": 5, "multiplier": "0.503", "payout": "0.50" },
    { "path": "RRLRRRRR", "slot": 7, "multiplier": "3.52", "payout": "3.52" }
  ],
  "status": "won",
  "stake": "3.00",
  "payout": "5.03",
  "server_seed_hash": "863b48d8…",
  "nonce": "1"
}

Goal Jet — a shared round#

Crash games work differently: one flight is shared by everyone playing at your casino, so the round is not owned by a single player. Stakes go on before it starts; each player cashes out on their own.

• A player may hold more than one stake on the same flight.
• Cash-out moves through ACTIVE → SETTLING → WON. If your wallet times out mid-settlement, the retry resumes at the same multiplier — a player can never be shown a win we then fail to pay.
• The flight's crash point is committed before betting opens and verifiable afterwards, exactly as in Provably fair.

A flight sleeps when nobody is playing

It stops after about two minutes without a player and wakes on the next sign of life — which now includes POST /v1/sessions, so by the time your player's launcher connects the round is already open. Flying empty tables for every operator every quarter second is waste, and this is how it is avoided.

While it is asleep the last round stays in the table exactly as it ended, so /crash/state tells you which you are looking at:

To check without starting anything — and without minting a session you may not use — use GET /v1/catalogue/{gameId}/flight on the operator API. Reading it does not wake the flight. See running it from your own servers.

Round history#

This player's recent rounds in this game, with the fairness record attached to each so the client can offer a verify button without another round trip.