Stream Versus — User Guide
A short guide for hosts and opponents to start a live “battle”.
What you need
- A Chaturbate account
- Full Chaturbate Events API URL (e.g. https://eventsapi.chaturbate.com/events/<username>/<key>/)
- OBS Studio or other streaming software
- Stable internet connection
Launch steps
Step 1. Create a session
- Click “Create session” onstreamversus.com
- Paste your full Chaturbate Events API URL (for example,https://eventsapi.chaturbate.com/events/<username>/<key>/). We will detect your username and token automatically.No token yet? Create one here:https://ru.chaturbate.com/statsapi/authtoken/, then compose the URL likehttps://eventsapi.chaturbate.com/events/<your_username>/<your_token>/and paste it.
- We validate your key:
- if the key is invalid — polling stops, the saved key is removed, and you’ll be asked to re-enter it;
- if the key is valid — event polling starts and you become Player A in the session.


Notes:
- You cannot have more than one active session at a time. A new active session will automatically close your previous one.
- We use a long-lived cookie/JWT to identify the current user within a session.
Step 2. Invite an opponent
- Copy the invitation link in the interface
- Send it to your opponent
- Your opponent opens the link and pastes their full Chaturbate Events API URL (same format as above)
- After a successful check, the opponent joins as Player B
Invariants:
- A player is added to a session only after their key is validated
- If the opponent’s key is invalid, the system will reject the connection and ask for a correct key
Step 3. Add window capture in OBS and go live
- On the desired scene click “+” in Sources → “Window Capture” or “Screen Capture”
- Select the browser window with the battle/chat UI (e.g. this site)
- Crop and resize to fit your canvas (e.g. 1920×1080) if needed
- Place the layer where you want it in the scene stack
- Start streaming
Important: do not use a “Browser Source” with the overlay URL. We capture the browser window where the chat and game progress are displayed.
Step 4. Start the battle
- Click “Start battle” in the control UI
- A timer and score will appear. Points update automatically by events (1 token = 1 point)
- Battle ends automatically by rules:
- by silence (no activity)
- by time limit
- Emergency stop is available for moderator/system: ends immediately without determining a winner (and this is not a draw)
Common situations and solutions
- Invalid key:
- the system stops polling, removes the saved key, and asks you to enter a new one
- enter a valid key and try again
- Lost sync (no incoming events):
- the game flow is not paused, timers keep running
- automatic finish is blocked until sync is restored
- as soon as events resume, sync restores automatically
- No signals from both players:
- if there are no signals from both participants for 10 minutes, the session will automatically finish with status
expired_no_signals
- if there are no signals from both participants for 10 minutes, the session will automatically finish with status
- One active session per player:
- starting a new active session automatically closes all your other active sessions
Security and privacy
- The access key is used only to poll your stats and is stored locally for the current user; on access error it’s removed automatically
- No real money goes through the system: we track stats only and convert them to points
Where to get the Chaturbate Events API URL?
- Go tohttps://ru.chaturbate.com/statsapi/authtoken/and create an Events API URL
- Example: https://eventsapi.chaturbate.com/events/mankeyking/2OoKeRVMlpnyfrcuvvrcvW3Z/
- Paste this URL into the session interface field
- If the Chaturbate UI differs, look for the statistics/API section and the Events API option. See examples in the screenshots above.
Support
- If something doesn’t work (key is not validated, no events, overlay not visible), reload the page, check your internet, and re-enter the key
- If the issue repeats, contact project support. Please include what you did and the time it happened