How do I get UFC fight results the moment a fight ends?

curl -X POST "https://api.ufcalendar.com/v1/webhook-endpoints" \
  -H "Authorization: Bearer $UFCAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/hooks/ufcalendar", "events": ["fight.result", "card.changed"]}'

# The response returns the endpoint id and its signing secret (whsec_...), once.
# Store the secret: every delivery is signed with it.

# pip install flask
import hashlib
import hmac
import os
import time

from flask import Flask, abort, request

app = Flask(__name__)
SECRET = os.environ["UFCAL_WEBHOOK_SECRET"]  # the whsec_... value returned once at registration
results = {}  # fight_id -> latest delivery; use your database in production


def signature_ok(raw: bytes, header: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    expected = hmac.new(SECRET.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, v1) and abs(time.time() - int(t)) <= 300


@app.post("/hooks/ufcalendar")
def ufcalendar_hook():
    raw = request.get_data()  # verify the raw bytes, before any JSON parsing
    if not signature_ok(raw, request.headers.get("X-UFCalendar-Signature", "")):
        abort(400)
    delivery = request.get_json()
    if delivery["type"] == "fight.result":
        d = delivery["data"]
        # Upsert on fight_id: a correction arrives as a higher revision with "corrected": true
        if d["revision"] >= results.get(d["fight_id"], {}).get("revision", 0):
            results[d["fight_id"]] = d
            r = d["result"]
            print(f"{d['fighters']['a']} vs {d['fighters']['b']}: {r['winner'] or 'no winner'}, {r['method']}, R{r['round']} {r['time']}")
    return "", 204

// npm install @ufcalendar/sdk
// Polling fallback for plans without webhooks: fast while a card is live, slow otherwise.
import { FightAPI } from "@ufcalendar/sdk";

const api = new FightAPI(); // reads UFCAL_API_KEY from the environment
const watching = new Set(); // event slugs seen live
const announced = new Set(); // fight ids already handled

async function poll() {
  for await (const ev of api.events({ org: "ufc", status: "live" })) watching.add(ev.slug);
  for (const slug of watching) {
    const event = await api.event(slug);
    for (const f of event.card) {
      if (!f.result || announced.has(f.id)) continue;
      announced.add(f.id);
      const winner = [f.fighter_a, f.fighter_b].find((c) => c?.id === f.result.winner_fighter_id);
      console.log(`${f.fighter_a.name} vs ${f.fighter_b.name}: ${winner?.name ?? "no winner"}, ${f.result.method}, R${f.result.round} ${f.result.time}`);
    }
    // One last pass after the card flips to completed, so the main event is never missed
    if (event.status !== "live") watching.delete(slug);
  }
  setTimeout(poll, watching.size ? 60_000 : 15 * 60_000);
}

poll();

{
  "id": "res#83680",
  "type": "fight.result",
  "data": {
    "fight_id": 83680,
    "event": {
      "id": 2530,
      "slug": "ufc-333-2026-10-24",
      "title": "UFC 333: Volkanovski vs Evloev",
      "org": "ufc"
    },
    "fighters": { "a": "Petr Yan", "b": "Merab Dvalishvili" },
    "fighter_a": { "id": 360, "name": "Petr Yan" },
    "fighter_b": { "id": 194, "name": "Merab Dvalishvili" },
    "result": {
      "winner": "Petr Yan",
      "winner_fighter_id": 360,
      "method": "Decision - Unanimous",
      "round": 5,
      "time": "5:00"
    },
    "revision": 1,
    "corrected": false
  },
  "sent_at": …
}