Football live channel#

wss://sports.bzzoiro.com/live/football/

Auth, subscribe protocol and close codes are shared across channels — see the overview. This page documents every server frame with its real shape.

Coverage: Basic vs Full (WS+)#

Every covered match streams score, stats, positional data and odds. Matches flagged websocket_plus: true on GET /api/v2/events/live/ additionally stream action frames: individual match actions (~100 ms latency) with pitch coordinates and player info. The channel picks the best available source automatically — the subscribed frame tells you which you got:

subscribed — snapshot on subscribe#

{
  "type": "subscribed",
  "event_id": 223510,
  "source": "full",
  "event":    { "…": "same shape as the event frame below" },
  "livedata": [ "… up to 30 recent livedata frames …" ],
  "history":  [ "… recent action frames (full only) …" ],
  "odds":     { "…": "same shape as the odds frame below" }
}

event — score, clock and stats#

Sent whenever match state changes:

{
  "type": "event",
  "event_id": 223510,
  "home": { "id": 3021, "name": "Aldosivi", "short_name": "ALD" },
  "away": { "id": 3044, "name": "Gimnasia y Esgrima", "short_name": "GYE" },
  "score": { "home": 1, "away": 0 },
  "time": {
    "minute": 67, "second": 34, "display": "67'",
    "period": 2, "injury_time": null,
    "period_started_at_uts": 1785692700,
    "status": "live", "kickoff_at": "2026-08-02T17:30:00+00:00"
  },
  "stats": {
    "home": { "possession": 55, "shots_total": 11, "corners": 5, "xg": 1.42, "…": "…" },
    "away": { "possession": 45, "shots_total": 7,  "corners": 3, "xg": 0.71, "…": "…" }
  },
  "websocket_plus": true
}

Note: the clock lives under time (time.minute, time.display) — not at the top level.

livedata — ball position and situations#

Positional/situation updates, ~5 s cadence:

{
  "type": "livedata",
  "event_id": 223510,
  "uts": 1785695254,
  "side": "home",
  "situation": "dangerous_attack",
  "coordinates": [ { "x": 78.5, "y": 41.2 } ],
  "commentary": "Dangerous attack — Aldosivi"
}

• uts — unix timestamp in seconds
• side — "home", "away" or null
• coordinates — an array of {x, y} points (percent of pitch length × width, attacking left→right); usually one point
• situation values include: goal, corner, freekick, throwin, offside, goalkeeper_saved, shotoffwoodwork, dangerous_attack, attack, possession, safe

action — per-action events (Full only)#

Individual match actions with coordinates, ~100 ms after they happen:

{
  "type": "action",
  "event_id": 223510,
  "action_type": "goal",
  "x": 87.3, "y": 51.2,
  "team": "home",
  "player": { "id": 40112, "name": "T. Fernández" },
  "score": { "home": 1, "away": 0 },
  "qualifiers": [ "left_foot" ],
  "minute": 67, "second": 34, "period": 2,
  "ts": 1785695254123
}

action_type values include: goal, temp_goal, attempt_saved, temp_save, post, corner_awarded, offside_pass, foul, card, player_off, player_on, out. (temp_* frames are provisional and confirmed/corrected by a follow-up frame.)

odds — consensus odds (~30 s)#

{
  "type": "odds",
  "event_id": 223510,
  "odds": {
    "match_winner": { "home": 2.10, "draw": 3.20, "away": 3.60 },
    "over_under": { "over_15": 1.28, "under_15": 3.75, "over_25": 2.05,
                    "under_25": 1.78, "over_35": 3.90, "under_35": 1.26 },
    "btts": { "yes": 2.00, "no": 1.80 }
  },
  "updated_at": "2026-08-02T18:37:02+00:00"
}

odds_book — one bookmaker (~30 s)#

Sent only if you subscribed with bookmaker_slug. Same odds block plus "bookmaker_slug" and "bookmaker_name". Slugs: GET /api/v2/bookmakers/.

Other frames#

unsubscribed, pong, and error (codes listed in the overview).