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.

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": "specific-website",
  "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	Identifier for the website/casino offering the game
`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": "specific-website",
  "gameId": "2469f711-2da6-46b7-8648-3313dfdc5bb5",
  "username": "demo-player",
  "currency": "XXX",
  "platform": "DESKTOP"
}