Integration Docs

<iframe id="solex-frame"
  src="https://solex-integration-demo-production.up.railway.app/embed/embed/markets"
  style="width:100%;aspect-ratio:16/9;border:none;">
</iframe>

<script src="/solex-casino-sdk.js"></script>
<script>
  const sdk = new SolexCasinoSDK(
    document.getElementById('solex-frame'),
    {
      casinoId: 'your-partner-uuid',
      apiKey: 'sk_your_api_key',
      user: { id: 'player_123', displayName: 'Player' },
      balance: { available: 1500, reserved: 0,
                 currency: 'USD', currencySymbol: '$' },
    }
  );
  sdk.initialize();
</script>

<iframe id="traderhero-frame"
  src="https://solex-integration-demo-production.up.railway.app/jackpot/"
  style="width:100%;aspect-ratio:4/3;border:none;">
</iframe>

<script>
  const iframe = document.getElementById('traderhero-frame');

  // Send initial balance when iframe loads
  iframe.onload = () => {
    iframe.contentWindow.postMessage(
      { type: 'jackpot_balance_response', balance: 1500 },
      '*'
    );
  };

  // Listen for iframe messages
  window.addEventListener('message', (e) => {
    const { type, amount } = e.data;
    if (type === 'jackpot_balance_deduct') {
      // Player bet — deduct balance, confirm
      balance -= amount;
      iframe.contentWindow.postMessage(
        { type: 'jackpot_balance_response', balance },
        '*'
      );
    }
    if (type === 'jackpot_balance_credit') {
      // Player won — credit balance, confirm
      balance += amount;
      iframe.contentWindow.postMessage(
        { type: 'jackpot_balance_response', balance },
        '*'
      );
    }
  });
</script>

{
  "event": "deposit" | "win" | "refund",
  "transaction_id": "uuid-v4",       // Unique per webhook — use for idempotency
  "timestamp": "2026-03-02T12:00:00Z",
  "casino_id": "partner-uuid",
  "user_id": "external-user-id",
  "amount": 100.00,
  "currency": "USD",                  // Currency from partner config
  "metadata": {
    // Prediction Markets:
    "market_id": "uuid",
    "market_title": "...",
    "bet_id": "uuid",
    "outcome": "YES",

    // TraderHero:
    "game_type": "jackpot",
    "round_id": "uuid",
    "bet_amount": 25,
    "payout_amount": 50,
    "target_rtp": 90
  }
}

{
  "status": "success" | "failure",
  "balance": 1400.00,              // Updated balance after operation
  "reason": "insufficient_balance" // Only on failure
}

// Set during partner registration
POST /api/v1/casino/auth/register
{
  "name": "My Casino",
  "defaultCurrency": "EUR",    // USD, EUR, GBP, BTC, etc.
  ...
}

// Or update later
PATCH /api/v1/casino/admin/config
Headers: X-Casino-Key: your_key
{
  "defaultCurrency": "BTC"
}

// Currency flows through to:
// - Webhook payloads (currency field)
// - Transaction records
// - Prediction Markets SDK (CASINO_INIT balance.currency)
// - TraderHero (jackpot round currency field)

{
  "sub": "external_user_id",       // Required: your user ID
  "name": "Player Display Name",   // Optional: shown in UI
  "iat": 1709400000,
  "exp": 1709403600,
  "casino_id": "partner-uuid"      // Your partner ID
}

POST /api/v1/casino/auth/verify-jwt
Content-Type: application/json

{
  "jwt": "<token>",
  "casinoId": "<partner-uuid>"
}

// Success response
{
  "valid": true,
  "user": {
    "id": "internal-uuid",
    "displayName": "Test Player",
    "externalUserId": "external_user_id"
  },
  "session": {
    "token": "solex_session_...",
    "expiresAt": "2026-03-02T13:00:00Z"
  }
}