Aggregator API · v1

Add Freerounds

Reference guide and implementation details for add freerounds.

Grants free spins on one slot. The field name is freespins, not freerounds.

Item	Details
When	After createPlayer, before getGame
Grants	`freespins` on one `gameid`
Bet	`bet_level` 0–6 (not a cash amount)
Operator	Same game + active session stacks and extends validity
Lock	`bet_level` cannot change once the session is active

If the player is already in the game, spins start on the next available spin or game init.

To see the cash value of a bet level, credit free spins to yourself and read it inside the game.

Bet level notes

Bet amounts for a level may change over time
After the first free spin, the exact bet is locked for that session
An existing session on the same slot adds the new spins and extends valid_until
To issue a different bet level, use another slot — do not overlap sessions on the same game

Important bet_level cannot be changed on an already active free-spins session.

Method Request

{
  "api_login": "d13b1ceb-6209-4163-b1cf-f304c28b81ec",
  "api_password": "dqRin2nfLosij2n88",
  "method": "addFreeRounds",
  "gameid": "softswiss/LuckyCrew",
  "freespins": 12,
  "bet_level": 0,
  "valid_days": 7,
  "user_username": "yourPlayerId9959",
  "user_password": "superSecretPlayerPassword",
  "currency": "USD"
}

Successful Response

{
  "error": 0,
  "response": {
    "id": 7,
    "player_id": 57,
    "game_id": "softswiss/LuckyCrew",
    "freespins": 12,
    "freespins_wallet": 0,
    "freespins_performed": 0,
    "bet_level": 0,
    "currency": "USD",
    "operator_id": 4,
    "valid_until": "2023-10-17T12:19:16.700332Z",
    "created_at": "2023-10-10T12:19:16.700360Z",
    "updated_at": "2023-10-10T12:19:16.700363Z",
    "active": true
  }
}