All of our games inside your platform.
1Roll Gaming is our provider. You keep your brand, your players and your cash flow — we deliver the games via iframe, ready in minutes. We only charge 4% on profit (what players lose), and that amount accumulates for you to pay off gradually, whenever you want.
Full catalog
Mines, Crash, Plinko, Dice, Blackjack, Coinflip, slots and more — no development needed.
Integration in minutes
Create the key in the panel, open the session and show the game inside an iframe.
You control the money
You fund the session balance and receive everything left over when it closes.
How the 4% fee works
- The fee applies only to the profit: amount funded to the session minus the amount returned when it closes.
- If the player ends up winning, that session generates no fee at all.
- Every closed session adds the 4% to your outstanding balance — nothing is withheld from your money.
- You pay it down whenever and however much you want, straight from the panel.
- All entries are recorded in your integration's statement.
1. Credentials
Create your integration in the partner panel. You receive an API key (identifies the calls) and a secret (validates callback signatures).
x-api-key: pk_xxxxxxxxxxxxxxxx
Allowed domains are optional: with no domain registered, the iframe works on any site.
2. List games
GET https://1roll.win/api/public/partner/games
x-api-key: pk_...
200 → { "games": [ { "id": "mines", "title": "Mines", "launch_path": "/play/mines" } ] }3. Open session and fund balance
Accepted currencies: BRL, USDT, SOL, ETH. The session expires in 12 hours.
POST https://1roll.win/api/public/partner/session
x-api-key: pk_...
Content-Type: application/json
{ "player_ref": "user-123", "game": "mines", "amount": 100, "currency": "BRL" }
200 → {
"token": "pls_...", "balance": 100,
"launch_url": "https://1roll.win/play/mines?token=pls_..."
}<iframe src="{launch_url}" allow="autoplay; fullscreen"
style="width:100%;height:100%;border:0"></iframe>4. Check balance
GET https://1roll.win/api/public/partner/balance?player_ref=user-123¤cy=BRL
x-api-key: pk_...
200 → { "player_ref": "user-123", "currency": "BRL", "balance": 137.5 }5. Close session and receive balance
We return 100% of the remaining balance. The 4% fee on profit is not deducted here — it accumulates in the panel for you to pay later.
POST https://1roll.win/api/public/partner/close
x-api-key: pk_...
{ "token": "pls_..." }
200 → {
"status": "closed", "funded": 100, "returned": 70,
"net": -30, "fee": 1.2, "fee_rate": 0.04
}6. History
GET https://1roll.win/api/public/partner/history?player_ref=user-123&limit=50 x-api-key: pk_...
7. Signed callback
POST {your_callback_url}
x-partner-event: session.closed
x-signature: HMAC-SHA256(secret, raw_body)const expected = crypto.createHmac("sha256", SECRET).update(rawBody).digest("hex");
if (expected !== req.headers["x-signature"]) return res.status(401).end();8. Errors
401 missing or invalid key / inactive integration 400 invalid parameter (game, currency or amount) 404 session or token not found 410 session closed or expired
Ready to get started?
Sign in with your 1Roll account (or create one on the spot) and generate your keys in seconds.
Open partner panelFee: 4% on profit, paid gradually. All calls are HTTPS and support CORS.
