Slot Machine Simulator API

About the Slot Machine Simulator API

A slot machine simulator API for casino-style games, demos and probability lessons, with no real money involved. Each call spins three to five reels up to five times, drawing every symbol with weighted probabilities so cherries turn up often and sevens rarely. You choose the number of spins, the number of reels and the bet per spin, starting from zero.

The Free plan returns what lands on each reel for every spin, as an emoji and a name, with the bet, the total amount wagered and the list of eight symbols the machine uses. That is enough to animate the reels in a browser game, a Discord bot or a party app and decide outcomes your own way.

Paid plans add the payout side: the winnings for each spin, its win type and a win flag, plus session totals for winnings, net profit, wins, losses and win percentage, and the payout multiplier for every symbol. That turns the simulator into a ready-made backend for a slot game, or a quick way to show how a run of spins moves a player's balance over time.

How it works

Each reel is filled independently by a weighted draw from eight symbols. The weights, out of 108, are Cherry 30, Lemon 25, Orange 20, Grape 15, Bell 8, Star 5, Diamond 3 and Seven 2, so a Cherry lands on about 28% of reels and a Seven on under 2%. Payout multipliers rise as symbols get rarer: 2, 3, 5, 10, 20, 50, 100 and 200.

Matches count from the leftmost reel only. The simulator counts how many reels in a row, starting at reel one, show the same symbol as reel one; the same symbol further along after a break does not count. If every reel matches, win_type is jackpot and payout is multiplier x bet x number of reels. If three or more match but not all, which needs four or five reels, win_type is match and payout is multiplier x bet x matched count x 0.5. Exactly two leading matches give small, paying half the bet for any symbol. Anything else is none with a payout of 0.

is_win is true whenever payout is above zero, so a small result counts toward wins although it returns less than the stake. total_bet is spins x bet, net_profit is total winnings minus total bet, and win_percentage is wins divided by spins, times 100. Money values are rounded to two decimals.

spins accepts 1-5, reels 3-5 and bet 0-1000. A bet of 0 is honoured and gives zero payouts. On the Free plan payout, win_type, is_win, the winnings, profit and win/loss totals, and each symbol's payout_multiplier are null.

What people use it for

Game Development

Implement slot machine mechanics in casino games and gambling applications

Probability Analysis

Analyze slot machine probabilities and expected values for educational purposes

Entertainment

Provide safe, simulated slot machine experience without real money gambling

Testing

Test slot machine algorithms and payout structures for game design and balancing

Without writing code

The Slot Machine widget from WidgetSpark spins one on your desktop.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON

Default REST response

XML

Markup format

YAML

Human-readable

CSV

Tabular export

Beta

GraphQL

Query language

New

MCP

For AI agents

Request parameters — GET /v1/slotmachine

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them. Anything not listed here is dropped rather than passed through.

Optional

1
2

curl "https://api.apiverve.com/v1/slotmachine?spins=5&reels=3&bet=1" \
  -H "x-api-key: YOUR_API_KEY"

Authentication

Send your key in the x-api-key header. That is the only auth step — no token exchange, and no per-endpoint scope to configure.

Response — GET /v1/slotmachine

Every APIVerve endpoint returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164

{
  "status": "ok",
  "error": null,
  "data": {
    "total_spins": 5,
    "num_reels": 3,
    "bet_per_spin": 1,
    "spins": [
      {
        "spin_number": 1,
        "reels": [
          {
            "symbol": "🍋",
            "name": "Lemon"
          },
          {
            "symbol": "🍒",
            "name": "Cherry"
          },
          {
            "symbol": "🍒",
            "name": "Cherry"
          }
        ],
        "bet": 1,
        "payout": 0,
        "win_type": "none",
        "is_win": false
      },
      {
        "spin_number": 2,
        "reels": [
          {
            "symbol": "⭐",
            "name": "Star"
          },
          {
            "symbol": "🍋",
            "name": "Lemon"
          },
          {
            "symbol": "⭐",
            "name": "Star"
          }
        ],
        "bet": 1,
        "payout": 0,
        "win_type": "none",
        "is_win": false
      },
      {
        "spin_number": 3,
        "reels": [
          {
            "symbol": "🍊",
            "name": "Orange"
          },
          {
            "symbol": "🍇",
            "name": "Grape"
          },
          {
            "symbol": "🍋",
            "name": "Lemon"
          }
        ],
        "bet": 1,
        "payout": 0,
        "win_type": "none",
        "is_win": false
      },
      {
        "spin_number": 4,
        "reels": [
          {
            "symbol": "🍒",
            "name": "Cherry"
          },
          {
            "symbol": "⭐",
            "name": "Star"
          },
          {
            "symbol": "🔔",
            "name": "Bell"
          }
        ],
        "bet": 1,
        "payout": 0,
        "win_type": "none",
        "is_win": false
      },
      {
        "spin_number": 5,
        "reels": [
          {
            "symbol": "🍒",
            "name": "Cherry"
          },
          {
            "symbol": "🍒",
            "name": "Cherry"
          },
          {
            "symbol": "7️⃣",
            "name": "Seven"
          }
        ],
        "bet": 1,
        "payout": 0.5,
        "win_type": "small",
        "is_win": true
      }
    ],
    "total_bet": 5,
    "total_winnings": 0.5,
    "net_profit": -4.5,
    "wins": 1,
    "losses": 4,
    "win_percentage": 20,
    "available_symbols": [
      {
        "symbol": "🍒",
        "name": "Cherry",
        "payout_multiplier": 2
      },
      {
        "symbol": "🍋",
        "name": "Lemon",
        "payout_multiplier": 3
      },
      {
        "symbol": "🍊",
        "name": "Orange",
        "payout_multiplier": 5
      },
      {
        "symbol": "🍇",
        "name": "Grape",
        "payout_multiplier": 10
      },
      {
        "symbol": "🔔",
        "name": "Bell",
        "payout_multiplier": 20
      },
      {
        "symbol": "⭐",
        "name": "Star",
        "payout_multiplier": 50
      },
      {
        "symbol": "💎",
        "name": "Diamond",
        "payout_multiplier": 100
      },
      {
        "symbol": "7️⃣",
        "name": "Seven",
        "payout_multiplier": 200
      }
    ]
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Response headers

Every response carries your balance, so your own code always knows where it stands without polling anything. All four are exposed to browsers through CORS.

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change.

What a call costs — 1 credits per call

Credits are shared across every APIVerve API — one balance, one key, one bill. Failed requests never count against it, so a rejected input costs nothing.

Calls are what the credits buy at this API's rate — spend them here, on any of the other APIs, or across both. Nothing is reserved per endpoint.

Zero-code embed — one snippet, no backend

Drop an interactive Slot Machine Simulator form onto any page. The widget calls the API for you, so no key ever appears in your markup and there is nothing to deploy.

Changelog — Slot Machine Simulator API

Every change to this endpoint, newest first. Breaking changes ship as a new version and the previous one keeps serving — response fields are added, never removed or retyped in place, so an integration written against v1 keeps working.

Currently v1