Tracking Casino Events

Send casino events to Atlas for game analytics, RTP monitoring, and player behavior insights.

All API requests require an API Key passed via the X-API-Key header. Obtain yours at Dashboard → Settings → API Keys.

X-API-Key: your_api_key_here

Event Types

Casino events follow a three-phase lifecycle, all sent to the same endpoint. The Kafka topic is fixed: atlas.events.raw.casino.

Event	When to Send	Description
open	Immediately when bet is placed	Round started, bet amount deducted from balance
win	When round resolves with a win	Includes win amount credited to player
lose	When round resolves as a loss	win_amount = 0 or omitted

All three events are linked by the same bet_id. Send open first, then win or lose when the round settles.

Track Casino Open

cURL

curl -X POST https://events.atlas.io/api/v1/casino \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "org_abc123",
    "brand_id": "brand_xyz",
    "event": "open",
    "bet_status": "open",
    "user_id": "user_12345",
    "casino_session_id": "session_20260311_001",
    "bet_id": "round_20260311_001",
    "bet_dt": "2026-03-11T14:30:00Z",
    "game_ext_id": "pragmatic_gates_olympus",
    "game_name": "Gates of Olympus",
    "game_provider": "Pragmatic Play",
    "game_type": "slot",
    "bet_amount": 5.00,
    "bet_amount_bonus": 0.00,
    "currency": "BRL",
    "before_balance": 150.00,
    "is_free_bet": false
  }'

Track Casino Win

curl -X POST https://events.atlas.io/api/v1/casino \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "org_abc123",
    "brand_id": "brand_xyz",
    "event": "win",
    "bet_status": "win",
    "user_id": "user_12345",
    "casino_session_id": "session_20260311_001",
    "bet_id": "round_20260311_001",
    "bet_dt": "2026-03-11T14:30:05Z",
    "game_ext_id": "pragmatic_gates_olympus",
    "game_name": "Gates of Olympus",
    "game_provider": "Pragmatic Play",
    "game_type": "slot",
    "bet_amount": 5.00,
    "win_amount": 12.50,
    "win_amount_bonus": 0.00,
    "currency": "BRL",
    "before_balance": 145.00,
    "after_balance": 157.50,
    "is_free_bet": false
  }'

Track Casino Lose

curl -X POST https://events.atlas.io/api/v1/casino \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "org_abc123",
    "brand_id": "brand_xyz",
    "event": "lose",
    "bet_status": "lose",
    "user_id": "user_12345",
    "casino_session_id": "session_20260311_001",
    "bet_id": "round_20260311_002",
    "bet_dt": "2026-03-11T14:31:00Z",
    "game_ext_id": "pragmatic_gates_olympus",
    "game_name": "Gates of Olympus",
    "game_provider": "Pragmatic Play",
    "game_type": "slot",
    "bet_amount": 5.00,
    "win_amount": 0.00,
    "currency": "BRL",
    "before_balance": 157.50,
    "after_balance": 152.50,
    "is_free_bet": false
  }'

Request Fields

Envelope Fields (all events)

org_id · string · required

Organization identifier.

brand_id · string · required

Brand identifier.

event · string · required

Event type: open, win, or lose.

ip · string

Player IP address at round time.

geolocation_lat · number

Player latitude at round time.

geolocation_long · number

Player longitude at round time.

is_test · boolean

Marks the event as operator test traffic. When true, the event is accepted (202) but rerouted to an audit-only store — it never appears in analytics, dashboards or risk scoring. Defaults to false when omitted.

Casino Fields

user_id · string · required

Your internal user identifier. Must be consistent across all events for the same player.

casino_session_id · string · required

Session identifier used to correlate multiple rounds within the same casino session.

bet_id · string · required

Unique identifier for this game round. Must be the same across open, win, and lose events for the same round.

bet_dt · string · required

ISO 8601 timestamp of when the round happened.

bet_status · string

Status of the bet round. Mirrors the event field: open, win, or lose. Optional but recommended for downstream ClickHouse consumers.

game_ext_id · string · required

Your internal game identifier, or the provider’s game ID. Used for per-game analytics.

game_provider_ext_id · string

Optional provider-side game identifier when different from game_ext_id.

game_name · string · required

Human-readable game name (e.g., "Gates of Olympus", "Lightning Roulette").

game_provider · string · required

Game provider name (e.g., "Pragmatic Play", "Evolution", "NetEnt").

game_type · string · required

Game category: slot, roulette, blackjack, baccarat, poker, live, virtual, crash.

platform · string

Allowed values: WEB, MOBILE, APP.

bet_amount · number · required

Real-money bet amount. Excludes bonus amounts.

bet_amount_bonus · number

Bonus/free-spin bet amount. Tracked separately from real money for GGR calculation.

win_amount · number

Real-money win amount. 0 for a losing round. Omit for open events.

win_amount_bonus · number

Bonus win amount (wins from bonus bets).

currency · string · required

ISO 4217 currency code (e.g. BRL).

before_balance · number

Player balance before this round. Used for balance reconciliation.

after_balance · number

Player balance after this round.

is_free_bet · boolean

Indicates whether this bet was a free bet.

GGR Calculation

Atlas calculates GGR from casino events automatically:

GGR = sum(bet_amount) - sum(win_amount)

Bonus GGR is tracked separately:

Bonus GGR = sum(bet_amount_bonus) - sum(win_amount_bonus)

For accurate GGR reporting, always separate real-money and bonus amounts. Mixing them inflates GGR and breaks bonus liability tracking.

Batch Casino Events

curl -X POST https://events.atlas.io/api/v1/casino/batch \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "org_id": "org_abc123",
        "brand_id": "brand_xyz",
        "event": "open",
        "bet_status": "open",
        "user_id": "user_001",
        "casino_session_id": "session_20260311_002",
        "bet_id": "round_001",
        "bet_dt": "2026-03-11T14:30:00Z",
        "game_ext_id": "pragmatic_gates_olympus",
        "game_name": "Gates of Olympus",
        "game_provider": "Pragmatic Play",
        "game_type": "slot",
        "bet_amount": 2.00,
        "currency": "BRL",
        "before_balance": 100.00
      },
      {
        "org_id": "org_abc123",
        "brand_id": "brand_xyz",
        "event": "lose",
        "bet_status": "lose",
        "user_id": "user_001",
        "casino_session_id": "session_20260311_002",
        "bet_id": "round_001",
        "bet_dt": "2026-03-11T14:30:02Z",
        "game_ext_id": "pragmatic_gates_olympus",
        "game_name": "Gates of Olympus",
        "game_provider": "Pragmatic Play",
        "game_type": "slot",
        "bet_amount": 2.00,
        "win_amount": 0.00,
        "currency": "BRL",
        "before_balance": 98.00,
        "after_balance": 98.00
      }
    ]
  }'