Resolve live outcomes with one API.
Register an event, get the outcome with the evidence behind it, and settle it. API access is rolling out through the developer waitlist.
Built for standard integration patterns—not a ground-up rebuild.
From credentials to first interaction.
Auth
Use your approved partner key in the X-Partner-Key header.
Create event
Create a prediction event for the stream or clip you are scripting.
Submit call
Send the interaction call and receive the prediction id for state polling.
Webhook
Handle prediction.started and prediction.settled webhook deliveries.
POST /v1/predictions/launch
X-Partner-Key: pllay_sk_live_xxxxxxxxxxxxxxxx
Idempotency-Key: 3f29b6c2-8e35-4a41-9c7a-2b6e0b8b9b10
Content-Type: application/json
{
"creator_external_id": "acme-games-042",
"question": "Who wins this round?",
"options": ["Team Red", "Team Blue"],
"timer_seconds": 60
}Real and verified — the exact request this endpoint accepts today, with a placeholder key and idempotency key. View the complete API reference.
Choose your integration.
API
Available NowConnect PLLAY services directly to your application or platform.
Any backend language, over HTTPS and JSON.
View request exampleEmbed
Available NowPlace a brand-configured participation experience inside an existing product.
Any web-based product.
See it on PlatformOverlay
Available NowAdd interactive moments to supported stream and broadcast workflows.
OBS browser source — live on Twitch today.
See it on PulseOne event. One resolution path.
Launch a prediction for a linked creator.
The prediction accepts responses immediately after launch.
Optionally stop new participation before the result is recorded.
Report the real-world result that settles the prediction.
Settlement is immediate and authoritative the moment the result is recorded.
Rewards and the settlement ledger update as part of the same resolution.
Campaign and interaction analytics are available through scoped reporting access.
See the request that starts this path.
What the verify endpoint can queue against.
- Apex Legends
- Call of Duty: Warzone
- Counter-Strike 2
- Dota 2
- Fortnite
- League of Legends
- Madden NFL 26
- NBA 2K26
- Overwatch 2
- PUBG: Battlegrounds
- Rainbow Six Siege
- Rocket League
- Rocket League Sideswipe
- Valorant
Adapter files the verify endpoint queues against today. A well-formed adapter name outside this set is accepted into the queue but has no benchmarked adapter to run. See all titles
The controls production teams expect.
Authentication
Every request carries a partner key in the X-Partner-Key header — the key is the credential, checked on every call.
Webhooks
An HMAC-SHA256 signature over the exact JSON body, using the partner's own webhook secret. A failed delivery retries as attempt 2 after about 4 seconds and attempt 3 after about 16 seconds — three attempts total, then marked dead with no further retries.
Errors
Every error uses this same envelope. request_id correlates a failure with PLLAY support; documentation_url anchors to this reference; retryable states plainly whether retrying the exact same request could ever succeed; field_errors is present only on a field-level validation failure. A response carries its request id in an X-Request-Id header as well, success or error; an inbound X-Correlation-Id header, if supplied, is echoed back verbatim.
Platform Intelligence
A second, read-only API — 5 routes for participation analytics on your own content, gated by a separate intelligence:read scope.
Full reference: Authentication, Webhooks, Errors, Platform Intelligence, Security and System Status.
Create and manage skill-based competitions.
Beyond predictions, PLLAY supports tournaments and duels — competition-based events where players earn rewards based on their performance and ranking.
POST /v1/tournaments/create — Create a new tournament
POST /v1/tournaments/{id}/settle — Record final standings
GET /v1/tournaments/{id}/players — Query participant roster
POST /v1/duels/create — Create a 1v1 duel challenge
POST /v1/duels/{id}/settle — Settle match resultBoth tournament and duel settlement use Vision AI for instant verification. See the Event Types section below for how competition settlement differs from predictions.
Two settlement models, one outcome path.
Predictions
event_type="prediction"
- Player action: Predict the outcome of a match
- Settlement: Based on prediction accuracy
- Verification: Vision AI analyzes match result
Competitions
tournament_entry | duel_entry
- Player action: Enter a tournament or duel
- Settlement: Based on player ranking/performance
- Verification: Vision AI verifies match results
Key difference: Predictions settle on prediction accuracy; competitions settle on player performance and ranking. Both use Vision AI for instant, authoritative outcome verification.
Step-by-step integration walkthroughs.
Build the first playable moment.
Choose an integration path, connect an authorized event source and launch your first PLLAY interaction.