Overview
Integration guide for receiving live MMA odds, heartbeats, settlements, and control messages. We deliver structured CloudEvents-formatted payloads to REST endpoints on your platform.
About this integration
What you will receive and how the data reaches your platform.
Our odds engine generates live MMA predictions and transforms them into normalized betting markets and odds. These are pushed directly to REST endpoints that your platform exposes.
Your endpoints will receive deltas, snapshots, heartbeats, settlements, and control messages — each wrapped as a CloudEvent so routing, replay, and observability stay consistent across events.
Data flow
How predictions move from our models through the odds engine into your platform, with persistence underneath.
Live odds pipeline
Prediction Models
Model output
Odds Engine
Formats & delivers via S3P
DocumentDB
State & snapshots
Partner Platform
S3P integration
Message types summary
CloudEvent types your endpoints will receive and when they are sent.
| Message Type | CloudEvent Type | When Sent |
|---|---|---|
| Odds Delta | S3P.v1.Event.Betting.OddsChanges | Every prediction update |
| Odds Snapshot | S3P.v1.Event.Betting.OddsSnapshot | On connect / round start / request |
| Heartbeat | S3P.v1.Session.Heartbeat | Every 5s when no odds sent |
| Settlement | S3P.v1.Event.Betting.MarketSettlements | Round end / fight end |
| Deactivation | S3P.v1.Event.Betting.OddsChanges | Fight over / round settled |
| Rollback | S3P.v1.Event.Betting.RollbackMarketSettlements | Correction needed |
Quick reference
Identifiers and enums commonly set on payloads and connection metadata.
Sport
MIXED_MARTIAL_ARTS
Producer
LIVE
Provider
ODDS_THIRD_PARTIES_PROVIDER