UFC odds in the MMA Fight Data API: consensus lines, line movement and closing odds

$ curl "https://api.ufcalendar.com/v1/fights/62368/odds" \
    -H "Authorization: Bearer $UFCAL_KEY"

{
  "data": {
    "fight_id": 62368,
    "status": "completed",
    "event": { "id": 489, "slug": "ufc-229-2018-10-07",
               "title": "UFC 229: Khabib vs McGregor", "org": "ufc",
               "starts_at": "2018-10-07T02:00:00.000Z" },
    "fighter_a": { "id": 1966, "slug": "khabib-nurmagomedov", "name": "Khabib Nurmagomedov" },
    "fighter_b": { "id": 2033, "slug": "conor-mcgregor", "name": "Conor McGregor" },
    "closing": {
      "a": { "american": -168, "decimal": 1.595, "implied_probability": 0.6269 },
      "b": { "american": 141, "decimal": 2.41, "implied_probability": 0.4149 },
      "favourite": "a",
      "fair_probability_a": 0.6017,
      "sources": 6,
      "recorded_at": "2018-10-07T00:39:06.000Z"
    },
    "opening": { "a": { "american": -115, ... }, "b": { "american": -115, ... },
                 "favourite": null, "recorded_at": "2017-04-13T23:07:26.000Z", ... },
    "consensus": { ... },  // settled bout: the same point as "closing"
    "movement": { "delta_points_a": 9.2, "direction": "a",
                  "since": "2017-04-13T23:07:26.000Z" },
    "points": 217,
    "updated_at": "2018-10-07T00:39:06.000Z"
  },
  "meta": {
    "note": "UFCalendar consensus line across the sportsbooks we track (book identities are not exposed). Information only, not betting advice.",
    "checked_at": "…",
    "history": "/v1/fights/62368/odds/history"
  }
}

from ufcalendar import FightAPI

api = FightAPI()  # UFCAL_API_KEY in the environment

# The closing line next to the result: what the market priced, and what happened
card = api.event_odds("ufc-229-2018-10-07")
for f in card["fights"]:
    close = f["closing"]
    if not close:
        continue  # unpriced bout: the row is present, the line is null
    fav = f["fighter_a"] if close["favourite"] == "a" else f["fighter_b"]
    print(f"{f['fighter_a']['name']} vs {f['fighter_b']['name']}:",
          close["a"]["american"], "/", close["b"]["american"],
          "favourite:", fav["name"] if close["favourite"] else "pick'em")

# Pro plans: every movement point, oldest first
for p in api.fight_odds_history(62368, limit=500):
    print(p["recorded_at"], p["a"]["american"], p["b"]["american"], p["sources"])

import { FightAPI } from "@ufcalendar/sdk";

const api = new FightAPI(); // UFCAL_API_KEY in the environment

// Opening vs closing: how far did the market move on this bout?
const { consensus, opening, closing, movement } = await api.fightOdds(62368);
console.log("opened", opening?.a.american, "closed", closing?.a.american);
console.log(`moved ${movement?.delta_points_a} points toward`, movement?.direction);

// Or ask for the line inline on a normal event call:
// GET /v1/events/ufc-229-2018-10-07?include=odds  -> each bout carries odds: { a, b, favourite, ... }