UFC Live Stats API: round, clock and in-fight stats over WebSocket

$ curl "https://api.ufcalendar.com/v1/events/ufc-2026-09-20/live" \
    -H "Authorization: Bearer $UFCAL_KEY"

{
  "data": {
    "event": { "slug": "ufc-2026-09-20", "status": "live" },
    "current": {
      "phase": "round", "round": 2, "possible_rounds": 5,
      "clock_sec": 67, "official": false,
      "stats": { "a": { "sig_strikes_landed": 41, "takedowns_landed": 0,
                        "control_time_sec": 1, ... },
                 "b": { "sig_strikes_landed": 20, "takedowns_landed": 1, ... } },
      "timeline": [ { "t": "…", "type": "takedown", "round": 2,
                      "clock": "2:57", "side": "b" }, ... ]
    },
    "last": { "winner": "a", "method": "KO/TKO", "round": 1, "time": "4:56" }
  },
  "meta": { "live": true, "websocket": "wss://live.ufcalendar.com/v1" }
}

# Or hold one socket open and let every change come to you:
$ wscat -c "wss://live.ufcalendar.com/v1?key=$UFCAL_KEY"
> {"action":"subscribe","event":"ufc-2026-09-20"}
< {"type":"snapshot","data":{...}}
< {"type":"update","data":{...}}        # every few seconds while a round runs
< {"type":"fight.final","data":{...}}   # the moment a bout ends

import json, websocket   # pip install websocket-client

ws = websocket.create_connection(f"wss://live.ufcalendar.com/v1?key={UFCAL_KEY}")
ws.send(json.dumps({"action": "subscribe", "event": "ufc-2026-09-20"}))

while True:
    frame = json.loads(ws.recv())
    if frame["type"] == "pong" or not frame.get("data"):
        continue
    cur = frame["data"]["current"]
    if cur and cur["phase"] == "round":
        a, b = cur["stats"]["a"], cur["stats"]["b"]
        print(f"R{cur['round']} {cur['clock_sec']}s  sig {a['sig_strikes_landed']}-{b['sig_strikes_landed']}")
    if frame["type"] == "fight.final":
        print("FINAL:", frame["data"]["last"])

const ws = new WebSocket(`wss://live.ufcalendar.com/v1?key=${process.env.UFCAL_KEY}`);
ws.onopen = () => ws.send(JSON.stringify({ action: "subscribe", event: "ufc-2026-09-20" }));
ws.onmessage = (e) => {
  const { type, data } = JSON.parse(e.data);
  if (!data?.current) return;
  const { phase, round, clock_sec, stats, timeline } = data.current;
  if (phase === "round")
    console.log(`R${round} ${clock_sec}s  sig ${stats.a.sig_strikes_landed}-${stats.b.sig_strikes_landed}`);
  if (type === "fight.final") console.log("FINAL", data.last);
  // timeline[] carries round_start / knockdown / takedown / submission_attempt … with a clock
};