Get Game URL

Request a game URL with a one-time login code for a player. You can use this URL within an iframe or redirect mobile players to it directly.

When embedding in an iframe, you can use our Iframe Events API to communicate with the game — refresh balance, listen for bet events, detect insufficient balance, and more.

Endpoint

POST /game/game/url

Request

POST /game/game/url HTTP/1.1
Host: api.marbles.xyz
X-Marbles-Signature: <signature>
Content-Type: application/json

{
  "clientSessionId": "some-session-id",
  "clientPlayerId": "some-player-id",
  "operatorId": "operatorId",
  "partnerId": "my-casino",
  "gameId": "2469f711-2da6-46b7-8648-3313dfdc5bb5",
  "username": "unique-username",
  "currency": "USD",
  "platform": "MOBILE",
  "displayName": "Player Display Name",
  "lobbyUrl": "https://mylobby.url",
  "depositUrl": "https://mydeposit.url",
  "language": "en",
  "country": "US"
}

Parameters

Parameter	Type	Required	Description
`clientSessionId`	string	Yes	Your session identifier for this player
`clientPlayerId`	string	Yes	Your unique player identifier
`operatorId`	string	Yes	Your operator identifier (provided by 155.io)
`partnerId`	string	Yes	Your chosen identifier for the website/casino offering the game (you define this)
`gameId`	string	Yes	Game UUID from the `/game/games` endpoint
`username`	string	Yes	Unique username for the player
`currency`	string	Yes	ISO 4217 currency code (see Currencies)
`platform`	string	Yes	`"MOBILE"` or `"DESKTOP"`
`displayName`	string	No	Non-unique display name shown in game
`lobbyUrl`	string	No	URL to redirect player back to lobby
`depositUrl`	string	No	URL for player to make deposits
`language`	string	No	ISO 639-1 language code (see Languages)
`country`	string	No	ISO 3166-1 alpha-2 country code

Success Response

HTTP/1.1 200 OK
X-Marbles-Signature: <signature>
Content-Type: application/json

{
  "url": "https://game.marbles.xyz?otl=ABCDE...XYZ&country=US&language=en"
}

Response Fields

Field	Type	Description
`url`	string	Game URL with one-time login token

Fun Money Mode

Demo Mode

You can generate a demo link that lets players test the game with fun money by:

Omitting clientSessionId and clientPlayerId
Setting currency to XXX

This is useful for game previews or demo modes on your platform.

Example Fun Money Request

{
  "operatorId": "operatorId",
  "partnerId": "my-casino",
  "gameId": "2469f711-2da6-46b7-8648-3313dfdc5bb5",
  "username": "demo-player",
  "currency": "XXX",
  "platform": "DESKTOP"
}