Skip to main content
POST
https://s-apis.oppigames.com/
/
game
/
jackpot-configure
Jackpot Configure
curl --request POST \
  --url https://s-apis.oppigames.com/game/jackpot-configure \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-signature: <x-signature>' \
  --header 'x-timestamp: <x-timestamp>' \
  --data '
{
  "gameId": "<string>",
  "betPortion": 123,
  "jackpotPool": 123,
  "forOnce": true
}
'
{
    "status": "RS_OK",
    "data": [
        {
            "jackpotId": "200b4487-3e2d-4c83-a85d-3f6d7245ba10",
            "gameId": "G1742373671848",
            "betPortion": 5,
            "jackpotPool": 150000000,
            "status": 1,
            "forOnce":false,
            "createdAt": "2025-07-15T09:14:18.339Z",
            "updatedAt": "2025-07-15T09:14:18.339Z"
        }
    ]
}

​
Headers

​
x-api-key
string
required
A unique identifier associated with operator calling API.
​
x-signature
string
required
A SHA256 HMAC signature generated using the request body and timestamp. Format: HMAC_SHA256(JSON.stringify(data) + ’|’ + timestamp), signed using the provided secret key.
​
x-timestamp
string
required
An Unix timestamp (milliseconds) Used to verify the request’s freshness. Ensure the same value is used in signature generation.
The signature will remain valid for only 5 minutes from the provided timestamp.
​
Content-Type
string
required
Must be set to application/json.

​
Request Body

​
gameId
string
required
Unique identifier representing the game for which you want to create the jackpot.
​
betPortion
integer
required
This is the percentage value to be extracted from each user’s bet. For example, if set to 5%, then 5% of every bet placed in this game will be added to the jackpot pool.
​
jackpotPool
integer
required
This is the total amount of the jackpot pool. Once the pool filled by betPortion contributions, reaches it’s limit, a portion of it will be awarded to users based on the mini-game logic. This amount is considered in USD. Bet in any currency will be converted to USD and then added to this pool. This pool will be awarded to user in their currency with our conversion rates.
To maintain precision and avoid floating-point errors, the balance field is processed as an integer value by multiplying the actual amount by 100000.For example, a balance of 12.34567 will be represented as 1234567 in the API.
​
forOnce
boolean
required
If forOnce = true, the jackpot will be a one-time reward and will no longer be effective once it has been awarded, whereas if forOnce = false, the jackpot will be recurring and remain effective until it is explicitly deleted.

​
Response

​
status
string
required
Code indicates status of the request weather it is succeed or failed. We have listed error codes here
​
data
array
required
An array of jackpot objects containing details about.
{
    "status": "RS_OK",
    "data": [
        {
            "jackpotId": "200b4487-3e2d-4c83-a85d-3f6d7245ba10",
            "gameId": "G1742373671848",
            "betPortion": 5,
            "jackpotPool": 150000000,
            "status": 1,
            "forOnce":false,
            "createdAt": "2025-07-15T09:14:18.339Z",
            "updatedAt": "2025-07-15T09:14:18.339Z"
        }
    ]
}