Sandbox API quickstart
Sign up for a free test key, configure your sandbox endpoint and launch a demo game with the aggregation API.
Sign up
Sign up for free sandbox access on casino-games-aggregation.com. No top-up or crypto is needed.
Get your sandbox key
Use the test API key and sandbox endpoint sent to you. Keep the key on your server and configure your IP/CIDR allowlist.
Launch a demo game
Send POST /api/v1/game-sessions/start with your sandbox key. Use data.iframe_url from the response to load the demo game, then exercise simulated wallet callbacks and the hosted test suite.
Start a game session
Set CASINO201_ENDPOINT to the sandbox endpoint sent with your key. The endpoint variable is a configuration placeholder, not a published sandbox hostname. These are example values; use a demo game ID available to your sandbox.
curl -X POST "$CASINO201_ENDPOINT/api/v1/game-sessions/start" \
-H "Authorization: Bearer $CASINO201_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"game_id": 123,
"player_id": "player_456",
"currency": "EUR",
"country_code": "US",
"ip_address": "203.0.113.24",
"locale": "en",
"device": "mobile",
"return_url": "https://yourcasino.com/lobby"
}'const response = await fetch(`${process.env.CASINO201_ENDPOINT}/api/v1/game-sessions/start`, {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.CASINO201_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
game_id: 123,
player_id: 'player_456',
currency: 'EUR',
country_code: 'US',
ip_address: request.ip,
locale: 'en',
device: 'mobile',
return_url: 'https://yourcasino.com/lobby',
}),
});
const { data: gameSession } = await response.json();
// Load gameSession.iframe_url for the player$payload = json_encode([
'game_id' => 123,
'player_id' => 'player_456',
'currency' => 'EUR',
'country_code' => 'US',
'ip_address' => $_SERVER['REMOTE_ADDR'],
'locale' => 'en',
'device' => 'mobile',
'return_url' => 'https://yourcasino.com/lobby',
]);
$curl = curl_init(getenv('CASINO201_ENDPOINT') . '/api/v1/game-sessions/start');
curl_setopt_array($curl, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('CASINO201_API_KEY'),
'Content-Type: application/json',
],
]);
$gameSession = json_decode(curl_exec($curl), true)['data'];
// Load $gameSession['iframe_url'] for the playerExample response
The following is the response example shown on the homepage, not an active session. Use the iframe_url returned by your own request.
{
"success": true,
"data": {
"session_id": 918274,
"session_token": "8f2c41d9e7a3b5…",
"expires_at": "2026-10-04T12:00:00+00:00",
"iframe_url": "https://api.casino201.com/start_game?token=8f2c41d9e7a3b5…"
}
}Verify your integration
Exercise authenticate, balance, bet, win, rollback and reward callbacks against the simulated balance. Verify each X-Signature before processing and use the hosted test suite included with sandbox access.
Full field reference is included with your sandbox key.