Skip to content
RealTimeBets

RealTimeBets API reference

The RealTimeBets API is a JSON API for licensed operators that returns live events, in-play prices and micro-markets, and settles the bets you record with signed webhooks. Base URL https://realtimebets.com/api/v1.

What the API covers

  • Events: matches in play and the next kickoffs, with score, clock, period and live stats.
  • Markets: match markets (result, winner, next goal) and micro-markets (next point, goal in a window, next possession, next drive, next round), each with decimal prices, probabilities, status and lock time.
  • Incidents: goals, points, scores, cards, plants, drives, with the second of the match they happened.
  • Streaming: a server-sent events stream that pushes the full market set of an event once a second.
  • Risk and bets: a risk check that answers accept, reduce or reject, and bet recording with settlement by webhook.

Conventions

  • Times are ISO 8601 in UTC, for example 2026-10-14T19:41:10Z.
  • Prices are decimal (2.36 returns 2.36 units per unit staked, stake included). probability is the engine's fair probability before margin.
  • Every response has data and meta. meta tells you whether the key is a sandbox key, the feed delay and the requests used and included in your plan.
  • Every object carries "sandbox": true or false.
  • Matches labelled "feed": "replay" are engine replays with fictional teams, available around the clock so you can integrate and test at any hour.

Quick start

curl https://realtimebets.com/api/v1/events?status=live \
  -H "Authorization: Bearer rtb_sb_your_key"

Get a sandbox key in the console after signing up. Production keys need a stored licence record and an active Platform plan, see Sandbox and limits.