155API

Freebets & Rewards

Create promotional freebets and rewards for players


Freebets allow operators to create promotional rewards that give players free bets on 155.io games.

Hub88 Integration Only

Freebets are currently only available for operators integrated through Hub88. Direct integration operators should contact us to discuss promotional options.

Getting Started

To enable freebets for your platform, follow these two steps:

Step 1: Request Prepaid Templates

Contact us to set up your freebet templates. We'll need:

InformationDescription
Operator IDYour Hub88 operator_id
Bet valueAmount per free bet (e.g., $1, $5, $10)
QuantityNumber of free bets in the reward
CurrencyWhich currencies to support (e.g., USD, EUR)
GamesAll 155.io games or specific games only

For example, a template with bet value: $2 and quantity: 5 gives the player 5 free bets worth $2 each. They can use them one at a time until all 5 are used.

Once configured, you'll receive prepaid_uuid(s) that you can use to create rewards.

Step 2: Create Rewards via Hub88

Use Hub88's Operator API to grant freebets to your players:

POST /operator/generic/v2/freebet/rewards/create
{
  "operator_id": "your-operator-id",
  "user": "player-123",
  "prepaid_uuid": "uuid-from-step-1",
  "start_time": "2025-01-01T00:00:00Z",
  "end_time": "2025-12-31T23:59:59Z"
}

See Hub88's Freebets API Documentation for full details.

Set Expiration Dates

Always set start_time and end_time when creating rewards. Otherwise, rewards will automatically expire after a few weeks.

How It Works

  1. You create a reward for a player via Hub88's API
  2. Player launches a 155.io game and sees the freebet available
  3. Player uses the freebet to place a bet (no real balance deducted)
  4. Winnings are credited as real money to the player's balance

Need Help?

Contact us to set up your prepaid templates or discuss promotional strategies.

On this page