Live Match WebSocket

event Match snapshot

Re-pushed every ~30s and on every score / status change. Stats block is the same shape as /api/v2/events/{id}/stats/ — all 40+ live counters plus tactical metrics (attack / dangerous-attack / ball-safe and their *_pct), computed pass accuracy, and one xg number per side (sum of per-shot xG from the live shotmap).

{
  "type": "event",
  "event_id": 204849,
  "home": {"id": 4823, "name": "Kyoto Sanga",
           "short_name": "Kyoto"},
  "away": {"id": 4825, "name": "Gamba Osaka",
           "short_name": "Gamba"},
  "score": {"home": 1, "away": 1},
  "time": {"minute": 90, "period": "penalties",
           "status": "penalties",
           "kickoff_at": "2026-05-02T11:00:00+00:00"},
  "stats": {
    "home": {
      "ball_possession": 52, "total_shots": 14,
      "shots_on_target": 5, "shots_off_target": 6,
      "shots_inside_box": 9, "blocked_shots": 3,
      "corner_kicks": 7, "fouls": 11,
      "yellow_cards": 2, "red_cards": 0,
      "passes": 412, "accurate_passes":
          {"value": 348, "total": 412, "pct": 84.5},
      "pass_accuracy_pct": 84.5,
      "big_chances": 2, "big_chances_missed": 1,
      "dribbles": 8, "interceptions": 11,
      "tackles": 14, "tackles_won": 9,
      "duels": 78, "ground_duels": 65,
      "aerial_duels": 13, "recoveries": 22,
      "long_balls": 28, "crosses": 16,
      "throw_ins": 14, "free_kicks": 9,
      "goal_kicks": 6, "offsides": 2,
      "clearances": 18, "dispossessed": 12,
      "goalkeeper_saves": 4, "total_saves": 4,
      "high_claims": 1, "punches": 0,
      "hit_woodwork": 1, "touches_in_penalty_area": 24,
      "final_third_entries": 38,
      "fouled_in_final_third": 4,
      "attack": 67, "ball_safe": 64,
      "dangerous_attack": 37,
      "attack_pct": 33, "ball_safe_pct": 41,
      "dangerous_attack_pct": 26,
      "xg": 1.42
    },
    "away": { /* same shape */ }
  }
}

livedata Ball / situation tick

Pushed every ~5s — one frame per upstream timeline event (ball trajectory, corner, free kick, goal, shot, etc.).

{
  "type": "livedata",
  "event_id": 204849,
  "uts": 1777745495516,
  "side": "home",
  "situation": "attack",
  "coordinates": [
    {"x": 65.5, "y": 42.0},
    {"x": 68.2, "y": 44.5},
    {"x": 71.0, "y": 47.0},
    {"x": 73.8, "y": 49.5}
  ]
}

side: "home" / "away" / null. situation values include attack, goal, corner, free_kick, goal_kick, throw_in, penalty, substitution, periodscore, etc.

odds Bookmaker consensus (default)

Pushed every ~30s and only when the consensus actually changes (no redundant frames). Consensus is the arithmetic mean across 11–12 bookmakers; the line is refreshed every 3 min for live + imminent kickoffs.

{
  "type": "odds",
  "event_id": 205764,
  "odds": {
    "match_winner": {
      "home": 2.07, "draw": 4.08, "away": 2.87
    },
    "over_under": {
      "over_15": 1.06, "under_15": 7.96,
      "over_25": 1.26, "under_25": 3.61,
      "over_35": 1.84, "under_35": 1.89
    },
    "btts": {"yes": 1.34, "no": 3.08}
  },
  "updated_at": "2026-05-06T08:36:23+00:00"
}

Decimal odds. Any market not present in the consensus is omitted (the key may be null). Use updated_at for staleness checks; the same value is repeated until upstream moves the line.

odds Markets exposed

Consensus is the true arithmetic mean across the books that quote the line. Goals only — over/under is the match total, not per-team or cards/corners. For a per-bookmaker breakdown or other markets call /api/v2/events/{id}/odds/comparison/.

Subscribe

// Default (consensus)
ws.send(JSON.stringify({
  action: "subscribe",
  event_id: 205764
}));

// Per-bookmaker — only Pinnacle quotes for this match
ws.send(JSON.stringify({
  action: "subscribe",
  event_id: 205764,
  bookmaker_slug: "pinnacle"
}));

// Stop the per-book stream (event/livedata stays)
ws.send(JSON.stringify({
  action: "unsubscribe",
  event_id: 205764,
  bookmaker_slug: "pinnacle"
}));

A client can keep both subscriptions open at once: the consensus odds frame still arrives every ~30 s, and on top of it you get one odds_book frame per change for each book you've asked for.

odds_book Per-bookmaker frame

Re-emitted only when a quote from this specific book moves. Same market shape as odds; missing markets are null.

{
  "type": "odds_book",
  "event_id": 205764,
  "bookmaker_slug": "pinnacle",
  "bookmaker_name": "Pinnacle",
  "odds": {
    "match_winner": {"home": 2.04, "draw": 4.10, "away": 2.84},
    "over_under": {
      "over_15": 1.06, "under_15": 8.50,
      "over_25": 1.285, "under_25": 3.70,
      "over_35": 1.78, "under_35": 1.96
    },
    "btts": {"yes": 1.31, "no": 3.20}
  },
  "updated_at": "2026-05-06T10:18:42+00:00"
}

event Per-side stats stats.home / stats.away

The eight base fields appear once the upstream stats feed publishes them (expected_goals typically around minute 5–10). The six premium counters arrive on a 2 min cadence while the match is in play and reach the final values once it ends.

livedata situation values

Pair with side (home / away / null) to know which team triggered the situation. Counting "dangerous" situations over a rolling window gives you the equivalent of a "dangerous attacks" stat.

Browser (JavaScript)

const ws = new WebSocket(
  "wss://sports.bzzoiro.com/ws/live/?token=YOUR_TOKEN"
);
ws.onopen = () => ws.send(JSON.stringify({
  action: "subscribe", event_id: 204849
}));
ws.onmessage = (e) => {
  const f = JSON.parse(e.data);
  if (f.type === "livedata") drawTick(f);
  if (f.type === "event")    updateScoreboard(f);
};

Python (websocket-client)

import json, websocket
ws = websocket.create_connection(
    "wss://sports.bzzoiro.com/ws/live/?token=YOUR_TOKEN"
)
ws.send(json.dumps({"action": "subscribe", "event_id": 204849}))
while True:
    print(json.loads(ws.recv()))