# BigBang Casino API — Full Reference

> B2B casino game aggregator API. One REST integration for 21 game providers and 2,300+ slot, table, crash, and live casino games. Free sandbox mode included.

## Overview

BigBang Casino API is a casino game aggregator service designed for iGaming operators, casino platforms, and developers who want to offer casino games without integrating each provider individually. The API provides:

1. A unified game catalog with metadata (RTP, volatility, themes, features)
2. Signed launch URLs that load games in iframes
3. Normalized wallet callbacks so your backend only implements one schema
4. Multi-currency support including crypto

## Game Providers (28 total)

| Provider | Game Count | Game Types |
|----------|-----------|------------|
| Spinomenal | 353 | Slots, Jackpots |
| Pragmatic Play | 193 | Slots, live casino |
| PenguinKing (Octoplay) | 191 | Slots |
| Playtech | 151 | Slots (Age of the Gods series) |
| Mascot Gaming | 150 | Slots |
| Endorphina | 143 | Slots |
| Synot | 121 | Slots |
| Platipus | 118 | Slots |
| Greentube (Novomatic) | 111 | Slots (Book of Ra, Lucky Lady's Charm) |
| 3 Oaks Gaming | 97 | Slots |
| Fugaso | 87 | Slots |
| Evoplay | 85 | Slots, instant games |
| Hacksaw Gaming | 84 | Slots |
| BGaming | 65 | Slots, crash games |
| Booming Games | 65 | Slots |
| Gamomat | 60 | Slots |
| ELA Games | 59 | Slots |
| Gamzix | 53 | Slots |
| Habanero | 46 | Slots, table games |
| Playson | 42 | Slots |
| Inout Games | 38 | Crash, instant games |
| Tomhorn Gaming | 34 | Slots |
| Fazi | 29 | Slots |
| Kajot | 19 | Slots (classic) |
| CrashGames | 19 | Crash, aviator-style |
| Bellink | 17 | Slots |
| PG Soft | 12 | Slots (mobile-first) |

Total: 2,300+ games

## API Reference

### Authentication
All requests require an API key in the Authorization header:
```
Authorization: Bearer ek_live_your_key_here
```
Sandbox keys use prefix `ek_test_` and work identically but with virtual balance.

### GET /games
Returns the full game catalog. Supports filters:
- provider: Filter by provider name
- theme: Filter by theme tag
- volatility: low, medium, high
- min_rtp / max_rtp: RTP range filter
- features: freespins, buybonus, megaways, etc.
- currency: Filter games available for a currency

Response includes per-game: id, name, provider, category, rtp, volatility, themes, features, thumbnail_url, supported_currencies.

### POST /launch
Creates a signed game session URL.

Request body:
- game_id (required): Game identifier
- user_token (required): Your player identifier
- currency (required): Session currency (EUR, USD, etc.)
- mode: "real" or "fun" (default: real)
- return_url: URL to redirect when player exits
- language: ISO 639-1 code

Response: { url: "https://...", session_id: "...", expires_at: "..." }

The URL loads the game in an iframe. JWT token embedded, 5-minute TTL.

### Wallet Callbacks (Your Endpoint)
You implement one POST endpoint. We send normalized callbacks:

Operations: authenticate, balance, bet, win, rollback, game_round

Each callback includes:
- event: Operation type
- user_token: Your player identifier
- amount: Transaction amount (for bet/win)
- currency: Session currency
- game_id: Game identifier
- round_id: Unique round identifier
- transaction_id: Unique transaction ID
- signature: HMAC-SHA256 of payload

Your response: { balance: 1234.56 }

### POST /users/create
Create a player account for API-managed users.
- user_token (required): Unique player identifier
- username: Display name
- currency: Player currency

### GET /users/{user_token}
Get player balance and account info.

## Free Sandbox Mode

Every API account includes a sandbox key (ek_test_ prefix):
- No credit card required to start
- 100,000 EUR virtual balance
- Full access to all 25 providers and 2,300+ games
- Real game clients load and play
- Wallet callbacks fire with sandbox:true flag
- Use for development, testing, and demos
- No time limit on sandbox usage

## Pricing

| Plan | Monthly Cost | Launches/mo | Providers | Support |
|------|-------------|-------------|-----------|---------|
| Sandbox | Free | Unlimited (test) | All 28 | Community |
| Starter | EUR 149 | 5,000 | 4 | Email |
| Growth | EUR 399 | 25,000 | All 28 | Priority |
| Enterprise | Custom | Unlimited | All 28 | Dedicated |

## Integration Timeline

Average go-live: 2-5 days
1. Sign up and get sandbox key (instant)
2. Implement /games catalog browsing
3. Implement /launch to open games
4. Implement wallet callback endpoint
5. Test with sandbox
6. Switch to live key

## Comparison with Competitors

### vs SoftSwiss
- BigBang: No revenue share, flat monthly fee. SoftSwiss: Revenue share model.
- BigBang: Free sandbox. SoftSwiss: No public sandbox.
- BigBang: Self-service API. SoftSwiss: Enterprise sales process.

### vs Slotegrator
- BigBang: REST API first. Slotegrator: Platform-based.
- BigBang: Transparent pricing. Slotegrator: Custom quotes only.

### vs EveryMatrix
- BigBang: Developer-focused API. EveryMatrix: Full platform suite.
- BigBang: Lower entry cost. EveryMatrix: Enterprise pricing.

## Technical Specifications

- Protocol: HTTPS REST (JSON)
- Authentication: Bearer token (API key)
- Callback signing: HMAC-SHA256
- Launch URL format: Signed JWT, 5-min TTL
- Median launch latency: <100ms
- Catalog response: <20ms (cached)
- Uptime SLA: 99.9%
- Rate limits: 1,000 req/min (Sandbox), 10,000 req/min (Growth+)

## Use Cases

1. **Casino operators**: Add 2,300+ games to your platform with one integration
2. **Crypto casinos**: Native BTC/ETH/USDT support per session
3. **White-label platforms**: Resell game access to sub-operators
4. **Game lobbies**: Build custom React/Vue lobbies with our catalog API
5. **Sportsbook add-on**: Add casino games alongside your sportsbook
6. **Affiliates**: Demo games in fun mode on review sites

## Contact

- Website: https://api.bigbangcasino.bet/
- Documentation: https://api.bigbangcasino.bet/docs/
- Email: support@bigbangcasino.bet
- Telegram: https://t.me/bigbangcasinoapi