The shape of the API
Requests from your side go to a single endpoint as JSON POST bodies. Each one carries your login, your password and the name of the method you want. Responses come back as JSON. There are no separate base URLs per product and no second spec for live casino or sport: one igaming API covers the whole catalog of over 40,000 games and the sportsbook.
Traffic in the other direction, from us to you, is the seamless wallet: we call your server whenever a player's balance needs reading or changing. Those callbacks arrive as signed HTTP GET requests with query parameters.
Methods you call
| Purpose | What it returns or does |
|---|---|
| Currencies | The player currencies enabled for your account |
| Game list | Every title with its identifier, name, studio, thumbnail and normalized game type |
| Provider list | The studios your account can open |
| Create player | Registers a player with a fixed currency |
| Launch game | A real-money launch URL for an iframe |
| Launch demo | A play-for-fun URL, no player or wallet needed |
| Player history | The player's rounds, bets and wins, for support and reconciliation |
Game list
The game list is the backbone of your lobby. Each entry has a stable identifier that you store and pass back unchanged when launching. The game type field is already normalized across studios, so you can build "Slots", "Live", "Crash", "Table" and "Sport" sections straight from the response. Live tables and the sportsbook are simply entries in this list.
Launch
To open a game you send the player, the game identifier, the device (desktop or mobile) and the player's country, plus an optional language. You receive a URL to load in an iframe. Country matters: some studios exclude certain markets, and we enforce that from the country you send, never by guessing from an IP address. Send it on every real-money launch.
Demo
About 16,000 slots can be launched in demo mode with the same pattern. No player record is needed and no callbacks fire, which makes demo launches safe on public pages.
Seamless wallet callbacks
Player money never leaves your platform. We send three actions to your callback URL:
- balance: read the player's current balance, typically when a session opens.
- debit: a bet. Subtract it and return the new balance, or return an insufficient-funds code with the current balance.
- credit: a win. Add it and return the new balance.
Each call carries a unique transaction id, a round id and the game identifier. Amounts are integers in the currency's minor units. Your endpoint always replies HTTP 200; outcomes go in the JSON body as an error code: success, insufficient balance, or processing error.
Rollbacks
A rollback is not a separate action. It arrives as a debit or credit carrying a rollback flag, and you process it like any other movement. Your de-duplication on the transaction id is what keeps it safe.
Security
Every callback includes a timestamp and a key derived from that timestamp and your secret salt. Reject anything outside a short time window or with a key that does not match. For stronger protection, each callback also carries an HMAC-SHA256 header computed over all its parameters, so a tampered amount or username fails validation.
Free spins and free rounds
Two different things share this name, and it is worth being precise.
In-game free spins work across the catalog with nothing to build. Scatter-triggered free spins, bonus rounds, feature buys and jackpots run inside the game, and their winnings reach you as ordinary credits, often with no matching debit. Your handler must accept such credits.
Promotional free rounds, the kind you grant to a player as a welcome offer, are not self-service API calls on our side. If your bonus plan depends on granting free rounds, talk to us before you build it and we will tell you what can be arranged for the games you have in mind.
Currencies
Currency is set per player. One account can serve players in many currencies, or a site can be locked to one. The main multi-studio slot range and the sportsbook support 38 ISO currencies, including EUR, USD, GBP, CAD, AUD, BRL, MXN, ARS, INR, BDT, PKR, IDR, PHP, THB, VND, TRY, ZAR and ETB. Other ranges add or drop currencies studio by studio, so treat the currency method as the authority rather than any brochure.
Sportsbook through the same API
The sportsbook in our catalog, Nocturn Sport, is launched with the same call as a slot and settles through the same three callbacks. Pre-match and in-play bets debit the player when placed and credit them when settled, which may be hours or days later for an outright. Esports such as CS2, Dota 2 and Valorant sit alongside football, tennis and basketball. Our share on sportsbook GGR is 12%. The sport-specific details are on the sportsbook API page.
Multi-brand setups
Operators running several sites do not integrate twice. Each additional brand gets its own credentials and callback URL under the same account, and the catalog can differ by site if your licenses require it.
Next steps
Follow the step-by-step order on quick casino API integration, check costs on pricing, or request credentials on the API key page. If you are evaluating several aggregators, the comparison hub lines up how each one documents its wallet.
Frequently asked questions
What is a casino game aggregator API?
A single API that gives an operator access to games from many studios. You pull one game list, launch any title with the same call, and settle every round through one set of wallet callbacks.
Are wallet callbacks POST or GET?
GET, with query parameters, signed with a timestamp-based key and an HMAC-SHA256 header. Your endpoint replies HTTP 200 and reports errors in the JSON body.
How are rollbacks handled?
A rollback arrives as a debit or credit with a rollback flag and is processed like a normal movement, protected by de-duplication on the transaction id.
Can I grant promotional free rounds through the API?
Not as a self-service call. In-game free spins work automatically and pay through normal credits. For promotional free rounds, contact us before building your bonus plan.
Does the same API cover sports betting?
Yes. The Nocturn Sport sportsbook is an entry in the game list, opened with the same launch call and settled through the same callbacks.
How many currencies are supported?
38 ISO currencies on the main slot range and the sportsbook. Other game ranges vary by studio; the currency method returns what your account can use.