Quick Start

Get a live sportsbook in front of a player in three steps. Everything happens on your backend except the final <iframe>.

1. Get your site API key

Your site API key is issued to you at onboarding, together with your site id. It is a per-site secret that authenticates your backend to the Launch endpoint.

Server-side only

The site API key is not a value you make up, and it must never reach the browser. Keep it on your server and use it only for the server-to-server Launch call.

Throughout these docs we use the placeholders <YOUR_SITE_ID> and <YOUR_SITE_API_KEY>.

2. Call Launch from your backend

When a player opens the sportsbook, your backend calls POST /api/launch with the site API key and the player's context:

curl -X POST https://api.oddyne.com/api/launch \
  -H "Authorization: Bearer <YOUR_SITE_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "siteId": "<YOUR_SITE_ID>",
    "userId": "<YOUR_PLAYER_ID>",
    "username": "player_display_name",
    "currency": "USD",
    "lang": "en",
    "device": "desktop",
    "view": "live"
  }'

The response contains a ready-to-embed url:

{
  "url": "https://<EMBED_HOST>/?siteId=<YOUR_SITE_ID>&token=<jwt>&lang=en&theme=classic&view=live&device=desktop",
  "token": "<jwt>",
  "expiresAt": "2026-08-09T12:00:00Z"
}

See the Launch guide for the full request/response contract.

3. Embed the returned url

Drop the url we returned into an <iframe> — exactly as given. You do not add siteId, token, or lang; they are already baked into the URL.

<iframe
  src="https://<EMBED_HOST>/?siteId=<YOUR_SITE_ID>&token=<jwt>&lang=en&theme=classic&view=live&device=desktop"
  style="width:100%; height:100%; border:0;"
  allow="fullscreen"
  title="Oddyne Sportsbook">
</iframe>

That's it. The sportsbook loads, authenticates the player from the token in the URL, and renders. See Embedding for responsive-wrapper patterns and sizing.

Next steps

• Wire up money — implement the wallet callbacks we call to debit stakes and credit winnings.
• Read the full Launch contract — every field and error in the Launch guide.
• Mint per session — the launch token is short-lived; call Launch each time a player opens the sportsbook.