Spinomenal API: the Demi Gods and Majestic King series for your casino

Spinomenal's approach: series, not one-offs

Spinomenal is a slot studio founded in 2014 and headquartered in Valletta, Malta. Its catalogue is organised around recurring series, where a successful theme returns with new mechanics, new art and a new number on the title.

The two most recognisable families are Book of Demi Gods, a mythology book-slot line that has reached a sixth instalment, and Majestic King, a lion-themed slot first released in July 2019 and followed by editions such as Sunset, Ice Kingdom, Book of Majestic King and, in 2025, Majestic King Hold & Hit.

For operators, that model has a clear benefit: once players like one episode, they recognise the next one and try it without persuasion. Your lobby can use that by grouping sequels rather than scattering them.

Building a Spinomenal shelf in the lobby

Group each franchise into one row and order it by episode. Players who arrive through Book of Demi Gods II will scroll to the later instalments, and the same goes for Majestic King fans moving from the original to the Hold & Hit edition.

getGameList makes this easy: every Spinomenal title comes with its name, image and id_hash, so you can match titles to a series by name and sort them in your own CMS. The normalised game_type puts them under slots, and play_for_fun_supported tells you which ones can be shown in demo to visitors.

Session style varies with the series. Book slots bring long, patient sessions waiting for the feature; hold-and-respin editions offer a shorter, more frequent bonus rhythm. Mixing both in one shelf keeps different player types inside the same franchise.

Connecting Spinomenal: requests and callbacks

There is one API for you to call and one endpoint for us to call. Your servers POST JSON to the v1 endpoint at api.softaggregator.com; our side sends signed GET callbacks to the URL you register for your website.

Your calls

• getProviderList to read Spinomenal's provider key, then getGameList for its titles.
• createPlayer once per customer, fixing the currency that customer plays in.
• getGame with gameid (id_hash), lang, currency, device, country and homeurl, returning the iframe URL; getGameDemo for fun mode.
• getPlayerHistory to review a player's rounds, most recent at the top, each round condensed into a single entry, up to 500 per request.

Our calls to your wallet

action=balance asks for the player's balance; action=debit takes a stake; action=credit pays a win. Amounts are integers in minor units (a 0.30 bet arrives as 30). Index call_id uniquely and return the original answer to any duplicate; use round_id to group a round; expect game_id to equal the id_hash exactly. Reply HTTP 200 with error 0 on success, 1 on insufficient funds (plus the balance), or 2 for a signature, player or processing problem. The signature is md5(timestamp + salt_key) with a 30-second window. Everything is spelled out in the SoftAggregator API documentation.

Features that pay without a new stake

In Book of Demi Gods the free spins, and in Majestic King Hold & Hit the respin bonus, are triggered by a paid spin but play out at no extra cost. Their winnings reach your wallet as credits that may have no debit alongside them.

Book them as they come. The type label (bet, win, bonus_fs) is there for your reports, not for validation, and it is never a reason to turn a credit away. If a movement has to be cancelled, the callback arrives flagged rb=1; reverse it once and only once.

Markets and currencies for Spinomenal

Spinomenal's catalogue appears in casinos across Europe, Latin America, Asia and Africa, and its bright, recognisable themes travel easily between them. Each player bets in the currency you assign at createPlayer.

Native currencies relevant here include EUR, USD, GBP, PLN, RON, TRY, BRL, MXN, ARS, INR, BDT, PKR, PHP, THB, VND, IDR, MYR, KRW, ZAR and ETB. Markets with a currency outside this set can run on a USD or EUR account, with the conversion done by the operator; reach out and we will discuss your currency.

What an aggregator adds to a Spinomenal launch

A Spinomenal franchise is more valuable next to the rest of your catalogue than on its own. Through a casino game aggregator API, the integration you build once serves Spinomenal, the other slot studios, crash titles, live dealer tables and sports betting from one player balance.

Your casino brand is the only one players see; credit is prepaid and shown live with alerts before it runs short; and engineers answer 24/7 via Telegram (@mentionso) and by email to [email protected]. As a general note, catalogue and currencies evolve continuously, and the live list is always in getProviderList and getGameList. More on the model behind it on our game aggregator API page.

Spinomenal: common operator questions

Sources and last update

Spinomenal's founding year, head office and the series episodes come from the studio's own portfolio pages and news items.

• Spinomenal website: portfolio pages for Book of Demi Gods II to VI and the Majestic King editions, September 2026
• Trade news on the Majestic King Hold & Hit release, March 2025, consulted September 2026
• SoftAggregator developer reference (docs.html), consulted September 2026

Last reviewed: 24 September 2026.

Explore more