Games API

Games API is the core API for using Hub88. It allows Operators to request and receive the list of available games, one singular game URL as well as a game round. All the games provided via the API are provided and implemented by Hub88.

Games API Reference

Get a Game URL

This endpoint can be used in DEMO mode when building or testing Hub88 integration. For DEMO mode, Operator has to pass "currency":"XXX". Parameters token, user can be omitted.

See more in Demo Mode Gameplay.

post

Returns the landing URL of the chosen game. Operator has to forward the user to the returned URL. There are several ways to forward the User: 1. Embed URL into iframe on your site; 2. Redirect User to the URL; 3. Open the URL in a new window/tab of browser.

Header parameters

X-Hub88-SignaturestringRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

userstring · min: 3Required

The unique user ID in the Operator’s system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

tokenstring · max: 255Optional

Operator's back end generates a token associated with the User, Game, player's current currency and maybe other parameters depending on the Operator's preferences. The token acts as an ID parameter for the game session. It is important that the currency is not changed during the current game session. If the User changes the currency or display unit, the Operator's backend needs to generate a new token and re-open the game with new token. In case of DEMO gameplay, this parameter may be omitted. Minimum length 10 characters, maximum length 255 characters.

Example: f562a685-a160-4d17-876d-ab3363db331c

sub_partner_idstringOptional

ID of Operator's sub-partner (brand, whitelabel, site, etc.) which uses same integration and credentials as an Operator. Used for detailed reporting and integration type switching. Sites under the same Operator can use different integration types: TransferWallet or SeamlessWallet. A single site (sub_partner_id) can NOT have both kinds of integration at the same time.

Example: my-casino-id

platformstring · enumRequired

The platform layout, either mobile or desktop, the User has. This property can be ignored, if the mode is chosen based on User's browser attributes (user-agent, resolution, ratio, orientation).

Example: GPL_DESKTOPPossible values:

operator_idintegerRequired

Unique identifier for the Operator in Hub88 system. Used to authorize incoming requests. You can obtain your operator_id from the Hub88 BackOffice after your Operator entity is registered and set up in the Hub88 system by the internal teams.

Example: 1

metaobjectOptional

Additional parameters which can be used for certain game Suppliers. It depends on the Operator's choice of Game Providers/Suppliers.

lobby_urlstring · max: 255Required

lobby_url specifies the URL to which the game redirects to when the user clicks the Home button in the UI. Maximum length 255 characters.

Example: https://amazing-casino.com/lobby

langstring · enumRequired

The ISO 639-1 language code, applicable to the User in the current session.

Example: enPossible values:

game_codestringRequired

The unique game identifier in Hub88 system in the form of a string. game_code can be obtained from the /game/list endpoint.

Example: clt_dragonrising

deposit_urlstringOptional

The page URL where a player/user can make a monetary deposit.

Example: https://amazing-casion.com/deposit

currencystring · enumRequired

The ISO 4217 currency code. The following list contains all currencies supported by our system. Note that native gameplay support for these currencies may vary per Provider. Please contact us to know which Provider supports which currencies.

Example: EURPossible values:

game_currencystring · enumRequired

The ISO 4217 currency code used for in-game display. While the operator handles all transactions in a fixed currency (e.g., “EUR”), the game may display values to the player in a different currency (e.g., “USD”). Note that in-game amounts displayed to the player may differ if the game_currency is not supported by the supplier.

Example: EURPossible values:

countrystring · enumRequired

The ISO 3166-1 country code, applicable to the User in the current session.

Example: EEPossible values:

Responses

200

application/json

urlstringOptional

The landing URL of the chosen game.

404Error

application/json

post

/operator/generic/v2/game/url

POST /operator/generic/v2/game/url HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 345

{
  "user": "john12345",
  "token": "f562a685-a160-4d17-876d-ab3363db331c",
  "sub_partner_id": "my-casino-id",
  "platform": "GPL_DESKTOP",
  "operator_id": 1,
  "meta": {},
  "lobby_url": "https://amazing-casino.com/lobby",
  "lang": "en",
  "game_code": "clt_dragonrising",
  "deposit_url": "https://amazing-casion.com/deposit",
  "currency": "EUR",
  "game_currency": "EUR",
  "country": "EE"
}

{
  "url": "https://launcher.hub88.io/games/encrypted/launcher?payload=QTEyOEdDTQ.9devd1DNo9.EgnhVhHU.cV3NFgAz1xO"
}

Get a Game round

post

The endpoint allows to retrieve details of a game round. round or transaction_uuid must be passed for the request to pass.

Header parameters

X-Hub88-SignaturestringRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

userstring · min: 3Optional

The unique user ID in the Operator’s system. In case of DEMO gameplay, this parameter may be omitted.

Example: john12345

transaction_uuidstringOptional

The transaction identifier, which you recive from us through the API during a gameplay.

Example: 16d2dcfe-b89e-11e7-854a-58404eea6d16

roundstringRequired

The round identifier, which you recive from us through the API during a gameplay.

Example: rNEMwgzJAOZ6eR3V

operator_idintegerRequired

Example: 1

Responses

200

application/json

The URL to the round details page, which you can embed.

urlstringOptional

The URL to the round details page, which you can embed. round or transaction_uuid must be passed for the request to pass.

400Error

application/json

post

/operator/generic/v2/game/round

POST /operator/generic/v2/game/round HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "user": "john12345",
  "transaction_uuid": "16d2dcfe-b89e-11e7-854a-58404eea6d16",
  "round": "rNEMwgzJAOZ6eR3V",
  "operator_id": 1
}

{
  "url": "https://the-best-game-provider.com/roundCheck?round=rNEMwgzJAOZ6eR3V"
}

Get the Game List

post

Provides a list of games that are available for the Operator.

Header parameters

X-Hub88-SignaturestringRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

operator_idintegerRequired

Example: 1

product_codestringOptional

Used to filter the game list by a specific product. When provided, only games associated with the given product code will be returned. If the product_code isn't provided, the full list of games is returned.

Example: ont

Responses

200

application/json

Full Game item on Hub88.

url_thumbstringRequired

The Game preview image URL.

Example: https://picture-hosting.com/blackjack/thumb.png

url_backgroundstringRequired

The Game background image URL.

Example: https://picture-hosting.com/blackjack/bg.png

productstringRequired

The Game Supplier (Provider).

Example: OneTouch

namestringRequired

The full name of a Game.

Example: Blackjack Classic

game_codestringRequired

The unique game identifier in Hub88 system in the form of a string. game_code can be obtained from the /game/list endpoint.

Example: ont_blackjackclassic

freebet_supportbooleanRequired

Shows if a Game supports creation of freebets.

Example: true

demo_game_supportbooleanRequired

Shows if the Game supports DEMO plays.

Example: true

enabledbooleanRequired

Shows if a Game is enabled or not

Example: true

categorystring · enumRequired

The game type as a category. The following enum contains all possible values.

Example: BlackjackPossible values:

release_datestring · dateRequired

A date when a Game is due to go live, displayed in RFC3339 / ISO8601 format.

Example: 2017-11-05

volatilityinteger · enumRequired

Shows how volatile a Game is on scale of 1-6.

1 - Low

2 - Medium-Low

3 - Medium

4 - Medium-High

5 - High

6 - Very High

Example: 6Possible values:

rtpstringRequired

Return To Players (rtp) percentage of the Game, shows how much of the total bet amount will be redistributed between players as winnings. Stored as decimal in a form of a string.

Example: 94.79

paylinesintegerRequired

Shows the maximum number of paylines available in a Game.

Example: 20

hit_ratiostringRequired

The hit ratio indicates the ratio between winning and losing bets in the span of 100 bets. The Ratio is stored as decimal in the form of a string. Can be sent as null, when the game is live or supplier hasn't forwarded the data.

Example: 24.47

languagesstring[]Required

List of languages supported by the game client.

Example: ["eng","jpn","kor","deu"]

themestring[]Required

List of themes assigned to the Game.

technologystring[]Required

Technologies used within the Game.

featuresstring[]Required

The features available in this Game.

post

/operator/generic/v2/game/list

POST /operator/generic/v2/game/list HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "operator_id": 1,
  "product_code": "ont"
}

200

[
  {
    "url_thumb": "https://picture-hosting.com/blackjack/thumb.png",
    "url_background": "https://picture-hosting.com/blackjack/bg.png",
    "product": "OneTouch",
    "platforms": [
      "GPL_DESKTOP",
      "GPL_MOBILE"
    ],
    "name": "Blackjack Classic",
    "game_code": "ont_blackjackclassic",
    "supplier_identifier": {
      "game_id": "0007",
      "game_code": "007007007",
      "game_code_mobile": ""
    },
    "freebet_support": true,
    "demo_game_support": true,
    "enabled": true,
    "category": "Blackjack",
    "blocked_countries": [
      "PL",
      "BG"
    ],
    "release_date": "2017-11-05",
    "volatility": 1,
    "rtp": "98.8",
    "paylines": 0,
    "hit_ratio": "45.50",
    "certifications": [
      "CURACAO",
      "MGA",
      "IOM"
    ],
    "languages": [
      "eng",
      "jpn",
      "kor",
      "deu"
    ],
    "theme": [
      "Vegas",
      "Blue",
      "Wood"
    ],
    "technology": [
      "HTML5"
    ],
    "features": [
      "Bonus Buy",
      "Bonus Rounds",
      "Network Jackpot",
      "In-game Jackpot"
    ]
  }
]

Get a List of Products

post

Provides a list of Products that are available for the Operator.

Header parameters

X-Hub88-SignaturestringRequired

RSA-SHA256 is used to sign the request body using the private key. The signature is validated using the public key associated with the provided operator_id.

Body

operator_idintegerRequired

Example: 1

Responses

200

application/json

product_namestringRequired

Unique name of the Product.

Example: Hacksaw Gaming

product_codestringRequired

Unique code assigned to the Product.

Example: hsg

product_logo_urlstringRequired

The logo url for a Product's logo.

Example: https://cdn.hub88.io/suppliers_logos/hacksaw.svg

post

/operator/generic/v2/products/list

POST /operator/generic/v2/products/list HTTP/1.1
X-Hub88-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "operator_id": 1
}

200

[
  {
    "product_name": "Hacksaw Gaming",
    "product_code": "hsg",
    "product_logo_url": "https://cdn.hub88.io/suppliers_logos/hacksaw.svg"
  }
]

PreviousSeamless Wallet response statuses - Operator API NextWallet API

Last updated 1 month ago

Was this helpful?

hashtagGames API Reference

hashtagGet a Game URL

hashtagGet a Game round

hashtagGet the Game List

hashtagGet a List of Products

Games API Reference

Get a Game URL

Get a Game round

Get the Game List

Get a List of Products