Developers API

Bet Make

{{ 'HTTP POST /api/play?api_key=<API_KEY>' }}

Request body, JSON-encoded

Parameter nameTypeRequiredDescriptionExample
symbolstringyesCurrency symbol"BTC"
chancestring, decimalyesBet chance, %"88.88"
isHighbooleanyesHigh/Lowtrue
amountstring, decimalyesBet amount"0.01"
userWageringBonusHashstringnoUser's wagering bonus hash, link"da49f4c33a"
faucetbooleannoFaucet modetrue
tleHashstringnoTLE unique hash, link"da4df4631f"

Request Example

POST /api/play?api_key=5008fedc-3e4a-41a9-b078-b73be4b5249f HTTP/1.1
Content-Type: application/json
User-Agent: DuckDiceBot/1.0.0
Accept: */*
Cache-Control: no-cache
Host: duckdice.io
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 110

{
  "symbol": "XLM",
  "amount": "0.1",
  "chance": "77.77",
  "isHigh": true,
  "faucet": false
}

Response, JSON-encoded

Parameter nameTypeDescriptionExample
betBetBet objectSee Bet
isJackpotbooleantrue, if bet is jackpottrue
jackpotStatusboolean, nullableJackpot status, null if no jackpot, false if bet amount is below minimum required to obtain a jackpot.true
jackpotobjectJackpot object, nullable
jackpot.amountstring, decimalJackpot amount"10.38069307"
userUserUser objectSee User

Bet

Parameter nameTypeDescriptionExample
hashstringUnique bet hash"bb7bd4578d9"
symbolstringCurrency symbol"XRP"
resultbooleanWin/Losetrue
isHighbooleanHigh/Lowtrue
numberintegerBet result number6559
thresholdintegerBet threshold2222
chancefloatBet chance, %77.77
payoutfloatBet payout multiplier1.273
betAmountstring, decimalBet amount"0.004"
winAmountstring, decimalWin amount"0.005092"
profitstring, decimalWin profit"0.001092"
minedstring, decimalDecoy mined amount"22.34302483"
nonceintegerBet nonce12349977
createdintegerCreated timestamp1705594955
gameModestringGame mode (main, faucet, bonus)"main"

User

Parameter nameTypeDescriptionExample
hashstringUnique user hash"ea6d2ba75a"
levelintegeruser paws2
usernamestringUsername"DuckDiceBot"
betsintegerTotal user's bets count6591995
nonceintegerUser's current seed's nonce95787
winsintegerUser's wins count1915822
luckfloatSee Luck99.94
balancestring, decimalUser's balance in currency"69.23805207"
profitstring, decimalUser's profit in currency"373.03978203"
volumestring, decimalUser's wagering in currency"77284.31558445"
absoluteLevelobjectAbsolute level data
absoluteLevel.levelintegerAbsolute level31
absoluteLevel.xpintegerAbsolute level xp448338
absoluteLevel.xpNextintegerXP to next level459700
absoluteLevel.xpPrevintegerXP on previous level405700

Response Example

HTTP/1.1 200 OK
            Date: Thu, 18 Jan 2024 14:33:47 GMT
            Content-Type: application/json
            Transfer-Encoding: chunked
            Connection: keep-alive
            Cache-Control: no-cache, private
            Server: cloudflare
            Content-Encoding: gzip

            {
              "bet": {
                "hash": "bb7bd4178d9",
                "symbol": "XLM",
                "result": true,
                "isHigh": true,
                "number": 6559,
                "threshold": 2222,
                "chance": 77.77,
                "payout": 1.273,
                "betAmount": "0.004",
                "winAmount": "0.005092",
                "profit": "0.001092",
                "mined": "0.0012011",
                "nonce": 81,
                "created": 1705594955,
                "gameMode": "main"
              },
              "isJackpot": true,
              "jackpotStatus": true,
              "jackpot": {
                "amount": "100500.00"
              },
              "user": {
              "hash": "ea6d2ba75a",
              "level": 2,
              "username": "DuckDiceBot",
              "bets": 6591995,
              "nonce": 82,
              "wins": 1915822,
              "balance": "69.23805207",
              "profit": "373.03978203",
              "volume": "77284.31558445",
              "absoluteLevel": {
                "level": 31,
                "xp": 448338,
                "xpNext": 459700,
                "xpPrev": 405700
              }
            }
            }

User info

{{ 'HTTP GET /api/bot/user-info?api_key=<API_KEY>' }}

Response, JSON-encoded

Parameter nameTypeDescriptionExample
hashstringUnique user hash"ea6d2ba75a"
usernamestringUsername"DuckDiceBot"
createdAtintegerUser created timestamp1705594955
levelintegeruser paws2
campaignstring, nullableUser's affiliate campaign tracking id"a7614e787e"
affiliatestring, nullableAffiliate username"Affiliate"
lastDepositobject, nullableLast deposit
lastDeposit.createdAtintegerDeposit created timestamp1705594955
lastDeposit.currencystringDeposit currency"BTC"
lastDeposit.amountstring, decimalDeposit amount"0.01234511"
wageredarrayWagered amounts by currency[]
wagered.*.currencystringWager currency"XRP"
wagered.*.amountstring, decimalWager amount"0.000222118"
balancesarrayUser's balances[]
balances.*.currencystringBalance currency"BTC"
balances.*.mainstring, decimal, nullableMain balance"0.000111"
balances.*.faucetstring, decimal, nullableFaucet balance"0.0919911"
balances.*.affiliatestring, decimal, nullableAffiliate balance"0.0770099"
wageringBonusesarrayActive wagering bonuses, see Wagering Bonus, only 1 item or empty[]
tlearrayActive / Finished TLEs[]
tle.*.hashstringTLE unique hash"a7614e787e"
tle.*.namestringTLE name"Halloween"
tle.*.statusstringStatus (active/finished)"active"

Wagering Bonus

Parameter nameTypeDescriptionExample
namestringWagering bonus name"January Deposit Bonus"
typestringgeneral/no-deposit/rotatable"general"
hashstringUser's wagering bonus hash"a7614e787e"
statusstringBonus status: active/canceled/wasted/expired/unlocked"active"
symbolstringUsers's bonus symbol"XLM"
marginstring, decimalUser's bonus margin amount"123.00"

Response Example

HTTP/1.1 200 OK
            Date: Thu, 18 Jan 2024 14:33:47 GMT
            Content-Type: application/json
            Transfer-Encoding: chunked
            Connection: keep-alive
            Cache-Control: no-cache, private
            Server: cloudflare
            Content-Encoding: gzip

            {
              "hash": "d6f7a12ab5",
              "username": "DuckDiceBot",
              "createdAt": 1568982432,
              "campaign": "a7614e787e",
              "affiliate": "Affiliate",
              "level": 5,
              "lastDeposit": {
                "createdAt": 1591005477,
                "currency": "XRP",
                "amount": "0.75"
              },
              "wagered": [
                {
                  "currency": "BTC",
                  "amount": "14.24675424"
                },
                {
                  "currency": "LTC",
                  "amount": "0.3914529"
                },
                {
                  "currency": "ETH",
                  "amount": "0"
                },
                {
                  "currency": "XRP",
                  "amount": "0"
                },
                {
                  "currency": "XLM",
                  "amount": "0"
                }
              ],
              "balances": [
                {
                  "currency": "BTC",
                  "main": "0.00001",
                  "faucet": "0.005599"
                },
                {
                  "currency": "ETH",
                  "main": "0.0199",
                },
                {
                  "currency": "DECOY",
                  "main": "10022.167011"
                }
              ],
              "wageringBonuses": [
                {
                  "name": "January Deposit Bonus",
                  "type": "general",
                  "hash": "d3f1f121b3",
                  "status": "active",
                  "symbol": "XLM",
                  "margin": "12.99",
                }
              ],
              "tle": [
                {
                  "hash": "d6f1a12ab3",
                  "name": "Halloween",
                  "status": "active"
                }
              ]
            }