Withdraw

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://provider.fizzybubbly.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
"Fizzy Bubbly Provider API MCP server": {
  "url": "https://provider.fizzybubbly.com/mcp"
}
Close
POST /wallet/withdraw

Headers

  • Signature string
  • Public-Key string
application/json

Body

  • amount number Required

    Minimum value is 0.

  • currency string Required
  • externalRngBetId string | null

    External RNG bet identifier for explicit external RNG handling

  • freeSpinsCampaignId string
  • gameId string Required
  • gameRoundId string Required
  • isFeatureBuy boolean | null

    Indicates if the bet is a feature buy bet

  • isFreeSpinsConsumed boolean | null

    Indicates if all free spins were consumed. This property will be always null for non free spins transactions. This property will be true for the last free spins bet transaction.

  • isGameRoundFinished boolean Required
  • metadata object
  • playerId string Required
  • sessionId string Required
  • transactionId string Required

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • balance number Required

      Minimum value is 0.

    • currency string Required
    • externalRngExtraWinAmount number | null

      Extra win amount from external RNG

    • externalRngSelectedWinMultiplier number | null

      Selected win multiplier from external RNG

    • ref object
  • 400 application/json

    Request could not be processed

    Hide response attributes Show response attributes object
    • code string

      Values are ERROR_UNKNOWN_ERROR, ERROR_BAD_REQUEST, ERROR_BAD_REQUEST_PLAYER_BLOCKED, ERROR_INVALID_SESSION, ERROR_SESSION_EXPIRED, ERROR_TRANSACTION_DUPLICATE, ERROR_TRANSACTION_WITHDRAW_NOT_FOUND, ERROR_TRANSACTION_INSUFFICIENT_FUNDS, ERROR_TRANSACTION_LIMIT_EXCEEDED, ERROR_TRANSACTION_REALITY_CHECK, or ERROR_ROLLBACK_TRANSACTION_NOT_FOUND.

    • message string
  • 401 application/json

    Request public key or signature is missing or invalid

    Hide response attributes Show response attributes object
    • code string

      Value is ERROR_INVALID_SIGNATURE.

    • message string
  • 500 application/json

    Internal error / Unknown error

    Hide response attributes Show response attributes object
    • code string

      Values are ERROR_UNKNOWN_ERROR or ERROR_TIMEOUT.

    • message string
POST /wallet/withdraw
curl \
 --request POST 'BASE_URL/wallet/withdraw' \
 --header "Content-Type: application/json" \
 --header "Signature: string" \
 --header "Public-Key: string" \
 --data '{"amount":42.0,"currency":"string","externalRngBetId":"string","freeSpinsCampaignId":"string","gameId":"string","gameRoundId":"string","isFeatureBuy":true,"isFreeSpinsConsumed":true,"isGameRoundFinished":true,"metadata":{},"playerId":"string","sessionId":"string","transactionId":"string"}'
Request examples
# Headers
Signature: string
Public-Key: string

# Payload
{
  "amount": 42.0,
  "currency": "string",
  "externalRngBetId": "string",
  "freeSpinsCampaignId": "string",
  "gameId": "string",
  "gameRoundId": "string",
  "isFeatureBuy": true,
  "isFreeSpinsConsumed": true,
  "isGameRoundFinished": true,
  "metadata": {},
  "playerId": "string",
  "sessionId": "string",
  "transactionId": "string"
}
Response examples (200)
{
  "balance": 42.0,
  "currency": "string",
  "externalRngExtraWinAmount": 42.0,
  "externalRngSelectedWinMultiplier": 42.0,
  "ref": {}
}
Response examples (400)
{
  "code": "ERROR_UNKNOWN_ERROR",
  "message": "string"
}
Response examples (401)
{
  "code": "ERROR_INVALID_SIGNATURE",
  "message": "string"
}
Response examples (500)
{
  "code": "ERROR_UNKNOWN_ERROR",
  "message": "string"
}