@ufcalendar/sdk 0.8.1 → 0.8.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +268 -23
- package/dist/index.d.ts +268 -23
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -227,6 +227,46 @@ interface OddsBlock {
|
|
|
227
227
|
/** When the line last moved. */
|
|
228
228
|
updated_at: string | null;
|
|
229
229
|
}
|
|
230
|
+
/** One prop market's consensus price. */
|
|
231
|
+
interface PropLine {
|
|
232
|
+
yes: OddsLine;
|
|
233
|
+
/** Null when fewer than two sportsbooks quote the "no" side. */
|
|
234
|
+
no: OddsLine | null;
|
|
235
|
+
/** "Yes" with the margin removed (method of victory: its share of all six outcomes), 4 places; null when unavailable. */
|
|
236
|
+
fair_probability: number | null;
|
|
237
|
+
/** How many sportsbooks backed this price. */
|
|
238
|
+
sources: number;
|
|
239
|
+
recorded_at: string;
|
|
240
|
+
}
|
|
241
|
+
/** Over/under on one rounds line. */
|
|
242
|
+
interface PropTotalRounds {
|
|
243
|
+
line: number;
|
|
244
|
+
over: OddsLine;
|
|
245
|
+
under: OddsLine | null;
|
|
246
|
+
fair_probability_over: number | null;
|
|
247
|
+
sources: number;
|
|
248
|
+
recorded_at: string;
|
|
249
|
+
}
|
|
250
|
+
/** Method of victory for one corner. */
|
|
251
|
+
interface PropMethodCorner {
|
|
252
|
+
ko: PropLine | null;
|
|
253
|
+
sub: PropLine | null;
|
|
254
|
+
dec: PropLine | null;
|
|
255
|
+
}
|
|
256
|
+
/** Prop-market consensus for one bout (information only, not betting advice). */
|
|
257
|
+
interface FightProps {
|
|
258
|
+
method: {
|
|
259
|
+
a: PropMethodCorner;
|
|
260
|
+
b: PropMethodCorner;
|
|
261
|
+
};
|
|
262
|
+
/** Ascending by line; the one with the most `sources` is the main line. */
|
|
263
|
+
total_rounds: PropTotalRounds[];
|
|
264
|
+
/** Goes the distance (yes) or ends inside it (no). */
|
|
265
|
+
distance: PropLine | null;
|
|
266
|
+
/** True once settled: every price is the last before the event start. */
|
|
267
|
+
closing: boolean;
|
|
268
|
+
updated_at: string | null;
|
|
269
|
+
}
|
|
230
270
|
/** `GET /v1/fights/{id}/odds`. */
|
|
231
271
|
interface FightOdds extends OddsBlock {
|
|
232
272
|
fight_id: number;
|
|
@@ -242,6 +282,8 @@ interface FightOdds extends OddsBlock {
|
|
|
242
282
|
slug: string;
|
|
243
283
|
name: string;
|
|
244
284
|
} | null;
|
|
285
|
+
/** Prop markets; null when no sportsbooks price them. */
|
|
286
|
+
props: FightProps | null;
|
|
245
287
|
}
|
|
246
288
|
/** One bout of `GET /v1/events/{id}/odds`. */
|
|
247
289
|
interface EventOddsRow extends OddsBlock {
|
|
@@ -257,6 +299,8 @@ interface EventOddsRow extends OddsBlock {
|
|
|
257
299
|
slug: string;
|
|
258
300
|
name: string;
|
|
259
301
|
} | null;
|
|
302
|
+
/** Prop markets; null when no sportsbooks price them. */
|
|
303
|
+
props: FightProps | null;
|
|
260
304
|
}
|
|
261
305
|
/** `GET /v1/events/{id}/odds` — card order, non-cancelled bouts, unpriced included. */
|
|
262
306
|
interface EventOdds {
|
|
@@ -1694,7 +1738,7 @@ declare class FightAPI {
|
|
|
1694
1738
|
|
|
1695
1739
|
/** Kept in lockstep with package.json and the User-Agent by
|
|
1696
1740
|
* `apps/api/src/surfaces.test.ts`. Bump all three together. */
|
|
1697
|
-
declare const VERSION = "0.8.
|
|
1741
|
+
declare const VERSION = "0.8.3";
|
|
1698
1742
|
|
|
1699
1743
|
/**
|
|
1700
1744
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -2250,9 +2294,9 @@ interface paths {
|
|
|
2250
2294
|
org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
|
|
2251
2295
|
/** @description Filter on lifecycle status; `postponed` is accepted (2026-09-24). `upcoming` = everything not yet over (announced, scheduled or live), soonest first. */
|
|
2252
2296
|
status?: components["schemas"]["EventStatusFilter"];
|
|
2253
|
-
/** @description
|
|
2297
|
+
/** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
|
|
2254
2298
|
from?: string;
|
|
2255
|
-
/** @description
|
|
2299
|
+
/** @description Last UTC calendar day, inclusive `YYYY-MM-DD`, matched against `starts_at` (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs `to=` the Sunday. Must be a real calendar day. */
|
|
2256
2300
|
to?: string;
|
|
2257
2301
|
/** @description Sort by start time. Defaults are contextual — see endpoint description. */
|
|
2258
2302
|
order?: "asc" | "desc";
|
|
@@ -2424,6 +2468,8 @@ interface paths {
|
|
|
2424
2468
|
* Event with full card
|
|
2425
2469
|
* @description Full fight card (both corners, results when completed), venue and event-scoped broadcast rows. Every event and card entry carries `sport` (e.g. `mma`, `bare-knuckle-boxing`). Renamed events 308-redirect from stale slugs.
|
|
2426
2470
|
*
|
|
2471
|
+
* **Card order is read over non-cancelled bouts only.** `ordering` runs headliner-first (1 = main event), and `ordering`, `card_section` and `is_main` describe the card as it stands — except on a `status: "cancelled"` entry, which keeps the slot and section it had when it was scratched. The promotion re-lays the card around it afterwards, so a cancelled entry can share an `ordering` with a live bout or sit in a section that no longer matches its neighbours. Filter `status != "cancelled"` before deriving running order or sections.
|
|
2472
|
+
*
|
|
2427
2473
|
* `include=eta` adds `eta` (ISO timestamp or `null`) to every card entry: the estimated start of that bout, by the same rule the website's event page uses. These are estimates, not a schedule — each card section anchors on its declared start, and every completed bout re-anchors the rest of its section on its real finish. Cancelled bouts get `null`.
|
|
2428
2474
|
*
|
|
2429
2475
|
* `include=odds` adds `odds` to every card entry: the current UFCalendar consensus line (`a`, `b`, `favourite`, `fair_probability_a`, `sources`, `recorded_at`), or `null` when the bout is unpriced. Information only, not betting advice; the opening/closing lines and movement are on `/v1/events/{idOrSlug}/odds`.
|
|
@@ -3229,7 +3275,7 @@ interface paths {
|
|
|
3229
3275
|
};
|
|
3230
3276
|
/**
|
|
3231
3277
|
* Consensus odds for one card
|
|
3232
|
-
* @description The UFCalendar consensus line for every non-cancelled bout on one card, in card order: `fights[]`, each with `fight_id`, `status`, both corners (`fighter_a`, `fighter_b`: `id`, `slug`, `name`), `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded), `closing` (settled bouts only: the last point at or before the event start), `movement` (opening → consensus in implied-probability points on corner a, with the `direction` the market moved), `points` and `updated_at`. Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed), `sources` (how many sportsbooks backed it) and `recorded_at`. A bout nobody has priced stays on the list with nulls and `points: 0`; `meta.priced` / `meta.unpriced` count both. `meta.checked_at` is when we last checked the market, whether or not the line moved. Consensus is the mean across the sportsbooks we track, refreshed every 30 minutes in the 48 hours before a card and every 2 hours otherwise; book identities are never exposed. Information only, not betting advice. An unknown event 404s.
|
|
3278
|
+
* @description The UFCalendar consensus line for every non-cancelled bout on one card, in card order: `fights[]`, each with `fight_id`, `status`, both corners (`fighter_a`, `fighter_b`: `id`, `slug`, `name`), `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded), `closing` (settled bouts only: the last point at or before the event start), `movement` (opening → consensus in implied-probability points on corner a, with the `direction` the market moved), `points` and `updated_at`. Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed), `sources` (how many sportsbooks backed it) and `recorded_at`. A bout nobody has priced stays on the list with nulls and `points: 0`; `meta.priced` / `meta.unpriced` count both. `meta.checked_at` is when we last checked the market, whether or not the line moved. Consensus is the mean across the sportsbooks we track, refreshed every 30 minutes in the 48 hours before a card and every 2 hours otherwise; book identities are never exposed. Each bout also carries `props` — method of victory per corner, total rounds over/under per line and goes the distance (`FightProps`, or null), described on `/v1/fights/{id}/odds`. Information only, not betting advice. An unknown event 404s.
|
|
3233
3279
|
*/
|
|
3234
3280
|
get: {
|
|
3235
3281
|
parameters: {
|
|
@@ -3340,7 +3386,8 @@ interface paths {
|
|
|
3340
3386
|
* "since": "2025-11-15T23:00:00.000Z"
|
|
3341
3387
|
* },
|
|
3342
3388
|
* "points": 1,
|
|
3343
|
-
* "updated_at": "2025-11-15T23:00:00.000Z"
|
|
3389
|
+
* "updated_at": "2025-11-15T23:00:00.000Z",
|
|
3390
|
+
* "props": null
|
|
3344
3391
|
* }
|
|
3345
3392
|
* ]
|
|
3346
3393
|
* },
|
|
@@ -3628,9 +3675,9 @@ interface paths {
|
|
|
3628
3675
|
fighter?: string;
|
|
3629
3676
|
/** @description Fighter slug or id — bouts this fighter won. */
|
|
3630
3677
|
winner?: string;
|
|
3631
|
-
/** @description
|
|
3678
|
+
/** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
|
|
3632
3679
|
from?: string;
|
|
3633
|
-
/** @description
|
|
3680
|
+
/** @description Last UTC calendar day, inclusive `YYYY-MM-DD`, matched against `starts_at` (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs `to=` the Sunday. Must be a real calendar day. */
|
|
3634
3681
|
to?: string;
|
|
3635
3682
|
/** @description `true` = main events only. */
|
|
3636
3683
|
main_events_only?: boolean;
|
|
@@ -4212,11 +4259,11 @@ interface paths {
|
|
|
4212
4259
|
};
|
|
4213
4260
|
/**
|
|
4214
4261
|
* Judges' scorecards for a bout
|
|
4215
|
-
* @description The official athletic-commission record: every judge, their score for each round, their card total, the decision type and any point deductions. UFC back to 1995, PFL to 2018, OKTAGON to 2025, RIZIN from March 2026 (Japan has no athletic commission — the record is the one published by the officials body that judges RIZIN). UFC cards are cross-checked against the official scorecards ufc.com publishes (Dana White's Contender Series and Road to UFC included, from March 2022), which also fill bouts the commission record does not cover. `source` says who published the cards: `commission-record`, `ufc-official-cards`, or a promotion's own slug (`oktagon-official`, `pfl-official`, `aca-official`).
|
|
4262
|
+
* @description The official athletic-commission record: every judge, their score for each round, their card total, the decision type and any point deductions. UFC back to 1995, PFL to 2018, OKTAGON to 2025, RIZIN 2019–2022 and from March 2026 (Japan has no athletic commission — the record is the one published by the officials body that judges RIZIN; before March 2026 RIZIN judged each fight as a whole, so those cards carry each judge's total for the fight and no rounds, and 2023–2025 was not published). UFC cards are cross-checked against the official scorecards ufc.com publishes (Dana White's Contender Series and Road to UFC included, from March 2022), which also fill bouts the commission record does not cover. `source` says who published the cards: `commission-record`, `ufc-official-cards`, or a promotion's own slug (`oktagon-official`, `pfl-official`, `aca-official`).
|
|
4216
4263
|
*
|
|
4217
4264
|
* `total_a`/`total_b` and every round are oriented to the bout's `fighter_a_id`/`fighter_b_id`, which are repeated on the payload so you never have to fetch the fight to read a card. `winner_fighter_id` is who THAT judge gave it to.
|
|
4218
4265
|
*
|
|
4219
|
-
* **Check `scores_known` before charting totals.** When it is false the commission published only the outcome, and `total_a`/`total_b` are a 1-0 / 1-1 / 0-0 placeholder rather than a score (
|
|
4266
|
+
* **Check `scores_known` before charting totals.** When it is false the commission published only the outcome, and `total_a`/`total_b` are a 1-0 / 1-1 / 0-0 placeholder rather than a score (pre-2005 commission records, and the RIZIN cards where the officials published only each judge's pick); `rounds` is empty on those cards.
|
|
4220
4267
|
*
|
|
4221
4268
|
* **A bout with no commission record answers 200, not 404** (2026-09-24): `cards: []`, `decision_type: null`, and `meta.note` says why (a finish, or cards not yet published). 404 is reserved for an unknown fight, so a client can tell the two apart.
|
|
4222
4269
|
*
|
|
@@ -4422,7 +4469,9 @@ interface paths {
|
|
|
4422
4469
|
};
|
|
4423
4470
|
/**
|
|
4424
4471
|
* Consensus odds for one bout
|
|
4425
|
-
* @description The UFCalendar consensus line for one bout: `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded), `closing` (settled bouts only, `completed` or `no_contest`: the last point at or before the event start; null until then), `movement` (opening → consensus: `delta_points_a` in implied-probability points on corner a, `direction` = the corner the market moved toward, `since`), `points` (stored points) and `updated_at` (when the line last moved). Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed) and `sources` (how many sportsbooks backed it). Consensus is the mean across the sportsbooks we track, in decimal space; book identities are never exposed. `meta.checked_at` is when we last checked the market, whether or not the line moved; `meta.history` is the movement series (Pro+). A bout nobody priced answers 200 with nulls and `points: 0`; 404 is reserved for an unknown fight.
|
|
4472
|
+
* @description The UFCalendar consensus line for one bout: `consensus` (the latest point; the closing line once the bout is settled), `opening` (the first point we recorded), `closing` (settled bouts only, `completed` or `no_contest`: the last point at or before the event start; null until then), `movement` (opening → consensus: `delta_points_a` in implied-probability points on corner a, `direction` = the corner the market moved toward, `since`), `points` (stored points) and `updated_at` (when the line last moved). Every point is `a` / `b` (`american`, `decimal`, raw `implied_probability`), `favourite`, `fair_probability_a` (margin removed) and `sources` (how many sportsbooks backed it). Consensus is the mean across the sportsbooks we track, in decimal space; book identities are never exposed. `meta.checked_at` is when we last checked the market, whether or not the line moved; `meta.history` is the movement series (Pro+). A bout nobody priced answers 200 with nulls and `points: 0`; 404 is reserved for an unknown fight.
|
|
4473
|
+
*
|
|
4474
|
+
* `props` carries the prop markets (`FightProps`, or null when no sportsbooks price them): `method` (per corner `a` / `b`: `ko`, `sub`, `dec` — each `yes` / `no` prices, `fair_probability` = its share of all six outcomes when all six are priced, `sources`), `total_rounds` (over/under per rounds line, ascending) and `distance` (goes the distance yes / no). Same consensus rule as the moneyline (the sportsbook mean; prediction markets excluded, a book far from the rest dropped, two sportsbooks minimum); prices are recorded until the event starts, so a settled bout carries its closing props (`closing: true`). Books post props in fight week. Information only, not betting advice.
|
|
4426
4475
|
*/
|
|
4427
4476
|
get: {
|
|
4428
4477
|
parameters: {
|
|
@@ -4529,7 +4578,136 @@ interface paths {
|
|
|
4529
4578
|
* "since": "2026-08-18T22:50:43.418Z"
|
|
4530
4579
|
* },
|
|
4531
4580
|
* "points": 57,
|
|
4532
|
-
* "updated_at": "2026-08-29T10:50:34.350Z"
|
|
4581
|
+
* "updated_at": "2026-08-29T10:50:34.350Z",
|
|
4582
|
+
* "props": {
|
|
4583
|
+
* "method": {
|
|
4584
|
+
* "a": {
|
|
4585
|
+
* "ko": {
|
|
4586
|
+
* "yes": {
|
|
4587
|
+
* "american": 411,
|
|
4588
|
+
* "decimal": 5.11,
|
|
4589
|
+
* "implied_probability": 0.1957
|
|
4590
|
+
* },
|
|
4591
|
+
* "no": null,
|
|
4592
|
+
* "fair_probability": 0.1649,
|
|
4593
|
+
* "sources": 12,
|
|
4594
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4595
|
+
* },
|
|
4596
|
+
* "sub": {
|
|
4597
|
+
* "yes": {
|
|
4598
|
+
* "american": 1322,
|
|
4599
|
+
* "decimal": 14.22,
|
|
4600
|
+
* "implied_probability": 0.0703
|
|
4601
|
+
* },
|
|
4602
|
+
* "no": null,
|
|
4603
|
+
* "fair_probability": 0.0593,
|
|
4604
|
+
* "sources": 12,
|
|
4605
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4606
|
+
* },
|
|
4607
|
+
* "dec": {
|
|
4608
|
+
* "yes": {
|
|
4609
|
+
* "american": 290,
|
|
4610
|
+
* "decimal": 3.9,
|
|
4611
|
+
* "implied_probability": 0.2564
|
|
4612
|
+
* },
|
|
4613
|
+
* "no": {
|
|
4614
|
+
* "american": -425,
|
|
4615
|
+
* "decimal": 1.235,
|
|
4616
|
+
* "implied_probability": 0.8095
|
|
4617
|
+
* },
|
|
4618
|
+
* "fair_probability": 0.216,
|
|
4619
|
+
* "sources": 11,
|
|
4620
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4621
|
+
* }
|
|
4622
|
+
* },
|
|
4623
|
+
* "b": {
|
|
4624
|
+
* "ko": {
|
|
4625
|
+
* "yes": {
|
|
4626
|
+
* "american": 462,
|
|
4627
|
+
* "decimal": 5.62,
|
|
4628
|
+
* "implied_probability": 0.1779
|
|
4629
|
+
* },
|
|
4630
|
+
* "no": null,
|
|
4631
|
+
* "fair_probability": 0.1499,
|
|
4632
|
+
* "sources": 12,
|
|
4633
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4634
|
+
* },
|
|
4635
|
+
* "sub": {
|
|
4636
|
+
* "yes": {
|
|
4637
|
+
* "american": 1078,
|
|
4638
|
+
* "decimal": 11.78,
|
|
4639
|
+
* "implied_probability": 0.0849
|
|
4640
|
+
* },
|
|
4641
|
+
* "no": null,
|
|
4642
|
+
* "fair_probability": 0.0715,
|
|
4643
|
+
* "sources": 12,
|
|
4644
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4645
|
+
* },
|
|
4646
|
+
* "dec": {
|
|
4647
|
+
* "yes": {
|
|
4648
|
+
* "american": 149,
|
|
4649
|
+
* "decimal": 2.49,
|
|
4650
|
+
* "implied_probability": 0.4016
|
|
4651
|
+
* },
|
|
4652
|
+
* "no": null,
|
|
4653
|
+
* "fair_probability": 0.3384,
|
|
4654
|
+
* "sources": 11,
|
|
4655
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4656
|
+
* }
|
|
4657
|
+
* }
|
|
4658
|
+
* },
|
|
4659
|
+
* "total_rounds": [
|
|
4660
|
+
* {
|
|
4661
|
+
* "line": 1.5,
|
|
4662
|
+
* "over": {
|
|
4663
|
+
* "american": -386,
|
|
4664
|
+
* "decimal": 1.259,
|
|
4665
|
+
* "implied_probability": 0.7942
|
|
4666
|
+
* },
|
|
4667
|
+
* "under": {
|
|
4668
|
+
* "american": 258,
|
|
4669
|
+
* "decimal": 3.58,
|
|
4670
|
+
* "implied_probability": 0.2793
|
|
4671
|
+
* },
|
|
4672
|
+
* "fair_probability_over": 0.7398,
|
|
4673
|
+
* "sources": 4,
|
|
4674
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4675
|
+
* },
|
|
4676
|
+
* {
|
|
4677
|
+
* "line": 2.5,
|
|
4678
|
+
* "over": {
|
|
4679
|
+
* "american": -193,
|
|
4680
|
+
* "decimal": 1.518,
|
|
4681
|
+
* "implied_probability": 0.6587
|
|
4682
|
+
* },
|
|
4683
|
+
* "under": {
|
|
4684
|
+
* "american": 153,
|
|
4685
|
+
* "decimal": 2.53,
|
|
4686
|
+
* "implied_probability": 0.3953
|
|
4687
|
+
* },
|
|
4688
|
+
* "fair_probability_over": 0.625,
|
|
4689
|
+
* "sources": 17,
|
|
4690
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4691
|
+
* }
|
|
4692
|
+
* ],
|
|
4693
|
+
* "distance": {
|
|
4694
|
+
* "yes": {
|
|
4695
|
+
* "american": -160,
|
|
4696
|
+
* "decimal": 1.625,
|
|
4697
|
+
* "implied_probability": 0.6154
|
|
4698
|
+
* },
|
|
4699
|
+
* "no": {
|
|
4700
|
+
* "american": 123,
|
|
4701
|
+
* "decimal": 2.23,
|
|
4702
|
+
* "implied_probability": 0.4484
|
|
4703
|
+
* },
|
|
4704
|
+
* "fair_probability": 0.5785,
|
|
4705
|
+
* "sources": 11,
|
|
4706
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4707
|
+
* },
|
|
4708
|
+
* "closing": true,
|
|
4709
|
+
* "updated_at": "2026-08-29T07:00:00.000Z"
|
|
4710
|
+
* }
|
|
4533
4711
|
* },
|
|
4534
4712
|
* "meta": {
|
|
4535
4713
|
* "note": "UFCalendar consensus line across the sportsbooks we track (book identities are not exposed). Information only, not betting advice.",
|
|
@@ -4617,9 +4795,9 @@ interface paths {
|
|
|
4617
4795
|
get: {
|
|
4618
4796
|
parameters: {
|
|
4619
4797
|
query?: {
|
|
4620
|
-
/** @description Earliest recorded day, inclusive `YYYY-MM-DD`. */
|
|
4798
|
+
/** @description Earliest recorded day (UTC), inclusive `YYYY-MM-DD`. */
|
|
4621
4799
|
from?: string;
|
|
4622
|
-
/** @description Latest recorded day, inclusive `YYYY-MM-DD`; must not precede `from`. */
|
|
4800
|
+
/** @description Latest recorded day (UTC), inclusive `YYYY-MM-DD`; must not precede `from`. */
|
|
4623
4801
|
to?: string;
|
|
4624
4802
|
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
4625
4803
|
cursor?: string;
|
|
@@ -4789,9 +4967,9 @@ interface paths {
|
|
|
4789
4967
|
query?: {
|
|
4790
4968
|
/** @description Launch org slug: `ufc`, `pfl`, `oktagon`, `bkfc` or `rizin`. Staged orgs 400 until promoted. */
|
|
4791
4969
|
org?: "ufc" | "pfl" | "oktagon" | "bkfc" | "rizin";
|
|
4792
|
-
/** @description
|
|
4970
|
+
/** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
|
|
4793
4971
|
from?: string;
|
|
4794
|
-
/** @description
|
|
4972
|
+
/** @description Last UTC calendar day, inclusive `YYYY-MM-DD`, matched against `starts_at` (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs `to=` the Sunday. Must be a real calendar day. */
|
|
4795
4973
|
to?: string;
|
|
4796
4974
|
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
4797
4975
|
cursor?: string;
|
|
@@ -5665,7 +5843,7 @@ interface paths {
|
|
|
5665
5843
|
};
|
|
5666
5844
|
/**
|
|
5667
5845
|
* Fighter profile
|
|
5668
|
-
* @description Bio, records, stats, UFCalendar Power Index summary, and CC-licensed images with attribution metadata (displaying the credit is a license requirement). **Read `records` and `stats`** (added 2026-09-24): `records` is a map keyed by a clean name — `pro_mma` (the career MMA record), `amateur_mma`, `pro_kickboxing`, …, and the org slug for a record INSIDE one promotion (`ufc`, `one`, `bkfc`) — each `{ value, source, scope }`; `stats` is ONE per-minute panel (SLpM, striking accuracy/defense, SApM, takedown average/accuracy/defense, submission average), always the
|
|
5846
|
+
* @description Bio, records, stats, UFCalendar Power Index summary, and CC-licensed images with attribution metadata (displaying the credit is a license requirement). **Read `records` and `stats`** (added 2026-09-24): `records` is a map keyed by a clean name — `pro_mma` (the career MMA record), `amateur_mma`, `pro_kickboxing`, …, and the org slug for a record INSIDE one promotion (`ufc`, `one`, `bkfc`) — each `{ value, source, scope }`; `stats` is ONE per-minute panel (SLpM, striking accuracy/defense, SApM, takedown average/accuracy/defense, submission average), always ONE sport (the fighter's headline sport: the `pro-mma` panel over MMA bouts in every promotion; `pro-knuckle` for a bare-knuckle fighter, `pro-muay-thai` / `pro-kickboxing` for a ONE striker; sports are never averaged together), with `basis: { bouts, orgs, source, scope }` stating exactly which bouts it averages over (e.g. 7 UFC bouts, or 18 MMA bouts across UFC + Oktagon); `null` when no real panel exists. `career_stats` is the raw per-source row list these are built from and stays unchanged for existing integrations.
|
|
5669
5847
|
*
|
|
5670
5848
|
* `next_fight` is the fighter's next booked bout (not completed or cancelled, on an event that has not been cancelled and started no more than ~6h ago; `result` is always null) and `last_fight` their most recent completed or no-contest bout — both in the same shape as a `source: "native"` row of `/history`, or `null`.
|
|
5671
5849
|
*
|
|
@@ -6144,7 +6322,7 @@ interface paths {
|
|
|
6144
6322
|
};
|
|
6145
6323
|
/**
|
|
6146
6324
|
* Career statistics
|
|
6147
|
-
* @description Raw per-source career rows, plus the readable split in `meta.records` / `meta.stats` (the same objects the fighter profile carries — read those unless you need the per-source rows). `data`: per-scope career stats (`pro-mma`, `amateur-mma`, …): record, strikes landed/absorbed per minute, accuracy/defense, takedown and submission averages, and `updated_at` (this route only). Exactly ONE row per scope; `source` names the publisher it came from: `public-records` (the complete multi-promotion career record) is preferred, then the promotion's own site (`ufc-stats`, `bkfc-official`, `one-official`, …), then `ufcalendar`. A `public-records` record is a point-in-time snapshot advanced by every settled bout UFCalendar tracked after it, so it matches the record on ufcalendar.com. A row's record and its stats cover the same bouts. `pro-mma` = the career record plus striking/grappling averages UFCalendar computes over EVERY settled bout it holds per-fight totals for, in any promotion (Contender Series included); its stats are null when no such bout exists. Org-scoped rows (`ufc-only`, `bkfc-only`, `one-only`) are the fighter's record INSIDE that promotion, not a career record: `ufc-only` carries a record AND averages UFCalendar derives from the fighter's tracked UFC bouts only (Contender Series excluded, `W-L-D` plus ` (n NC)`; both null until a UFC bout is settled — a Contender-Series-only fighter has no UFC stats), while `bkfc-only` / `one-only` carry the promotion's own published record.
|
|
6325
|
+
* @description Raw per-source career rows, plus the readable split in `meta.records` / `meta.stats` (the same objects the fighter profile carries — read those unless you need the per-source rows). `data`: per-scope career stats (`pro-mma`, `amateur-mma`, …): record, strikes landed/absorbed per minute, accuracy/defense, takedown and submission averages, and `updated_at` (this route only). Exactly ONE row per scope; `source` names the publisher it came from: `public-records` (the complete multi-promotion career record) is preferred, then the promotion's own site (`ufc-stats`, `bkfc-official`, `one-official`, …), then `ufcalendar`. A `public-records` record is a point-in-time snapshot advanced by every settled bout UFCalendar tracked after it, so it matches the record on ufcalendar.com. A row's record and its stats cover the same bouts. `pro-mma` = the career record plus striking/grappling averages UFCalendar computes over EVERY settled MMA bout it holds per-fight totals for, in any promotion (Contender Series included); its stats are null when no such bout exists. Bouts of another sport are averaged on that sport's row (`pro-knuckle` for bare-knuckle boxing, `pro-muay-thai`, `pro-kickboxing`, `pro-boxing`; a stats-only row with a null record when the fighter has no such record row) and never enter `pro-mma`. Org-scoped rows (`ufc-only`, `bkfc-only`, `one-only`) are the fighter's record INSIDE that promotion, not a career record: `ufc-only` carries a record AND averages UFCalendar derives from the fighter's tracked UFC bouts only (Contender Series excluded, `W-L-D` plus ` (n NC)`; both null until a UFC bout is settled — a Contender-Series-only fighter has no UFC stats), while `bkfc-only` / `one-only` carry the promotion's own published record. ufcstats', OKTAGON's and ACA's header records are CAREER records and ship under `pro-mma` (the `public-records` row wins the scope when present, unless ufcstats counts more bouts).
|
|
6148
6326
|
*/
|
|
6149
6327
|
get: {
|
|
6150
6328
|
parameters: {
|
|
@@ -7426,7 +7604,7 @@ interface paths {
|
|
|
7426
7604
|
};
|
|
7427
7605
|
/**
|
|
7428
7606
|
* Matchmaker board
|
|
7429
|
-
* @description UFCalendar's matchmaker for one MMA promotion (`ufc`, `pfl`, `oktagon`, `rizin`; `bkfc` 400s `unsupported_org` — the engine runs on the Power Index, which rates MMA only). Every candidate pair inside a division is scored 0–100 for rank proximity, momentum, competitiveness, readiness and story (rematches, trilogy deciders, eliminators): the promotion's official ladder where one exists plus the strongest active unranked Power Index fighters. UFC pairs are scored by UFCalendar's booking model (a ranker trained on every realized UFC booking), weighted by the stakes term; other promotions use the fitted heuristic. Fighters already booked leave the board, pairs already booked are excluded, and one fighter appears in at most two slips per division.
|
|
7607
|
+
* @description UFCalendar's matchmaker for one MMA promotion (`ufc`, `pfl`, `oktagon`, `rizin`; `bkfc` 400s `unsupported_org` — the engine runs on the Power Index, which rates MMA only). Every candidate pair inside a division is scored 0–100 for rank proximity, momentum, competitiveness, readiness and story (rematches, trilogy deciders, eliminators): the promotion's official ladder where one exists plus the strongest active unranked Power Index fighters. A promotion with no official ladder (`rizin`) draws only on its current roster — fighters whose latest bout in the promotion is within 450 days — and its pairs are weighted by what each fighter has done there (title fights, wins, career pedigree), so a former champion is not paired with a two-fight prospect. UFC pairs are scored by UFCalendar's booking model (a ranker trained on every realized UFC booking), weighted by the stakes term; other promotions use the fitted heuristic. Fighters already booked leave the board, pairs already booked are excluded, and one fighter appears in at most two slips per division.
|
|
7430
7608
|
*
|
|
7431
7609
|
* Without `division` the list is the cross-division top board (at most two slips per division); with it, that division's best pairs. `meta.divisions` lists the promotion's divisions (an unknown one 400s `invalid_division`), `meta.rankings_date` the ladder snapshot used (null when the promotion has no current ladder). Each slip: `key` (`lo-hi` fighter ids), `a` (red corner — the better-credentialed side) and `b` with `rank` (0 = champion, null = unranked), `power_index`, `streak` (signed: +3 = three straight wins) and `booked`; `score`; `win_probability_a` from the two Power Index ratings; `tags` (`title`, `eliminator`, `coinFlip`, `bothStreaking`, `finishers`, `trilogyDecider`, `unfinishedBusiness`, `rematch`, `unrankedGem`, `bounceBack`, `steppingUp`, `bothDue`, `booked`).
|
|
7432
7610
|
*
|
|
@@ -8780,7 +8958,9 @@ interface paths {
|
|
|
8780
8958
|
query?: {
|
|
8781
8959
|
/** @description Same values as `/v1/events`; `upcoming` = the venue's cards not yet over. */
|
|
8782
8960
|
status?: components["schemas"]["EventStatusFilter"];
|
|
8961
|
+
/** @description First UTC calendar day, inclusive `YYYY-MM-DD`, matched against the event's `starts_at` (first bell, UTC) — not the venue's local date. Must be a real calendar day. */
|
|
8783
8962
|
from?: string;
|
|
8963
|
+
/** @description Last UTC calendar day, inclusive `YYYY-MM-DD`, matched against `starts_at` (UTC). An evening card in the Americas starts after midnight UTC, so it falls on the next UTC day: a Saturday-night Las Vegas card needs `to=` the Sunday. Must be a real calendar day. */
|
|
8784
8964
|
to?: string;
|
|
8785
8965
|
order?: "asc" | "desc";
|
|
8786
8966
|
/** @description Opaque cursor from `meta.pagination.next_cursor`. */
|
|
@@ -10811,7 +10991,10 @@ interface components {
|
|
|
10811
10991
|
event_title: string;
|
|
10812
10992
|
event_slug: string;
|
|
10813
10993
|
org_slug: string;
|
|
10814
|
-
/**
|
|
10994
|
+
/**
|
|
10995
|
+
* Format: date
|
|
10996
|
+
* @description The UTC calendar day of the event's `starts_at` (first bell). An evening card in the Americas starts after midnight UTC, so it can read one day after the venue's local date; use the event's `starts_at` + `tz` for a local label.
|
|
10997
|
+
*/
|
|
10815
10998
|
date: string | null;
|
|
10816
10999
|
opponent_id: number | null;
|
|
10817
11000
|
opponent_name: string | null;
|
|
@@ -11124,7 +11307,10 @@ interface components {
|
|
|
11124
11307
|
event_name: string | null;
|
|
11125
11308
|
event_slug: string | null;
|
|
11126
11309
|
org_slug: string | null;
|
|
11127
|
-
/**
|
|
11310
|
+
/**
|
|
11311
|
+
* Format: date
|
|
11312
|
+
* @description `native` rows: the UTC calendar day of the event's `starts_at` (first bell) — an evening card in the Americas starts after midnight UTC, so it can read one day after the venue's local date. `history` rows carry no time, only the date as the publisher printed it (usually the venue's local date).
|
|
11313
|
+
*/
|
|
11128
11314
|
date: string | null;
|
|
11129
11315
|
opponent_id: number | null;
|
|
11130
11316
|
opponent_name: string | null;
|
|
@@ -11846,7 +12032,62 @@ interface components {
|
|
|
11846
12032
|
*/
|
|
11847
12033
|
since: string;
|
|
11848
12034
|
};
|
|
11849
|
-
/** @description
|
|
12035
|
+
/** @description One prop market's consensus price: the mean, in decimal space, across the sportsbooks we track, converted back to American. */
|
|
12036
|
+
PropLine: {
|
|
12037
|
+
yes: components["schemas"]["OddsLine"];
|
|
12038
|
+
/** @description Null when fewer than two sportsbooks quote the "no" side (method-of-victory props are mostly quoted "yes" only). */
|
|
12039
|
+
no: components["schemas"]["OddsLine"] | null;
|
|
12040
|
+
/** @description The "yes" outcome with the market margin removed, 4 places: from the yes/no pair, or for method of victory its share of all six outcomes (both corners × KO/TKO, submission, decision) when all six are priced. Null otherwise. */
|
|
12041
|
+
fair_probability: number | null;
|
|
12042
|
+
/** @description How many sportsbooks backed this price. Book identities are never exposed. */
|
|
12043
|
+
sources: number;
|
|
12044
|
+
/**
|
|
12045
|
+
* Format: date-time
|
|
12046
|
+
* @description When this price was recorded (the last move).
|
|
12047
|
+
*/
|
|
12048
|
+
recorded_at: string;
|
|
12049
|
+
};
|
|
12050
|
+
PropTotalRounds: {
|
|
12051
|
+
/** @description Rounds line (0.5, 1.5, 2.5, 3.5 or 4.5). */
|
|
12052
|
+
line: number;
|
|
12053
|
+
over: components["schemas"]["OddsLine"];
|
|
12054
|
+
/** @description Null when fewer than two sportsbooks quote the under. */
|
|
12055
|
+
under: components["schemas"]["OddsLine"] | null;
|
|
12056
|
+
/** @description Over with the market margin removed (from the over/under pair), 4 places; null without an under. */
|
|
12057
|
+
fair_probability_over: number | null;
|
|
12058
|
+
/** @description How many sportsbooks backed the over. */
|
|
12059
|
+
sources: number;
|
|
12060
|
+
/** Format: date-time */
|
|
12061
|
+
recorded_at: string;
|
|
12062
|
+
};
|
|
12063
|
+
PropMethodCorner: {
|
|
12064
|
+
/** @description This corner wins by KO/TKO. */
|
|
12065
|
+
ko: components["schemas"]["PropLine"] | null;
|
|
12066
|
+
/** @description This corner wins by submission. */
|
|
12067
|
+
sub: components["schemas"]["PropLine"] | null;
|
|
12068
|
+
/** @description This corner wins by decision. */
|
|
12069
|
+
dec: components["schemas"]["PropLine"] | null;
|
|
12070
|
+
};
|
|
12071
|
+
/** @description Prop-market consensus for one bout. Prediction markets and exchanges are excluded and a book far from the rest is dropped; a market needs at least two sportsbooks. Prices are recorded until the event starts. Information only, not betting advice. */
|
|
12072
|
+
FightProps: {
|
|
12073
|
+
/** @description Method of victory per corner (oriented to the bout's `fighter_a` / `fighter_b`). */
|
|
12074
|
+
method: {
|
|
12075
|
+
a: components["schemas"]["PropMethodCorner"];
|
|
12076
|
+
b: components["schemas"]["PropMethodCorner"];
|
|
12077
|
+
};
|
|
12078
|
+
/** @description Over/under per rounds line, ascending. The line with the most `sources` is the main one. */
|
|
12079
|
+
total_rounds: components["schemas"]["PropTotalRounds"][];
|
|
12080
|
+
/** @description The fight goes the distance (yes) or ends inside it (no). */
|
|
12081
|
+
distance: components["schemas"]["PropLine"] | null;
|
|
12082
|
+
/** @description True once the bout is settled: every price is the last one before the event start. */
|
|
12083
|
+
closing: boolean;
|
|
12084
|
+
/**
|
|
12085
|
+
* Format: date-time
|
|
12086
|
+
* @description When any market here last moved.
|
|
12087
|
+
*/
|
|
12088
|
+
updated_at: string | null;
|
|
12089
|
+
};
|
|
12090
|
+
/** @description The consensus line of one bout: current, opening, closing (settled bouts) and the movement between opening and the current line (the close once settled), plus the prop markets. */
|
|
11850
12091
|
FightOdds: {
|
|
11851
12092
|
fight_id: number;
|
|
11852
12093
|
status: components["schemas"]["FightStatus"] | null;
|
|
@@ -11882,8 +12123,10 @@ interface components {
|
|
|
11882
12123
|
* @description When the line last moved (= `consensus.recorded_at`).
|
|
11883
12124
|
*/
|
|
11884
12125
|
updated_at: string | null;
|
|
12126
|
+
/** @description Prop-market consensus (method of victory, total rounds, goes the distance); null when no sportsbooks price props for the bout. */
|
|
12127
|
+
props: components["schemas"]["FightProps"] | null;
|
|
11885
12128
|
};
|
|
11886
|
-
/** @description One bout of a card with its consensus line. Unpriced bouts stay on the list with nulls and `points: 0`. */
|
|
12129
|
+
/** @description One bout of a card with its consensus line and prop markets. Unpriced bouts stay on the list with nulls and `points: 0`. */
|
|
11887
12130
|
EventOddsRow: {
|
|
11888
12131
|
fight_id: number;
|
|
11889
12132
|
status: components["schemas"]["FightStatus"] | null;
|
|
@@ -11911,6 +12154,8 @@ interface components {
|
|
|
11911
12154
|
* @description When the line last moved (= `consensus.recorded_at`).
|
|
11912
12155
|
*/
|
|
11913
12156
|
updated_at: string | null;
|
|
12157
|
+
/** @description Prop-market consensus (method of victory, total rounds, goes the distance); null when no sportsbooks price props for the bout. */
|
|
12158
|
+
props: components["schemas"]["FightProps"] | null;
|
|
11914
12159
|
};
|
|
11915
12160
|
EventOdds: {
|
|
11916
12161
|
event: components["schemas"]["StorylineEvent"];
|
|
@@ -12694,4 +12939,4 @@ interface components {
|
|
|
12694
12939
|
}
|
|
12695
12940
|
type operations = Record<string, never>;
|
|
12696
12941
|
|
|
12697
|
-
export { type Article, type ArticleLocale, type ArticleSummary, type BonusAward, type BonusLedger, type Broadcast, type BroadcastRight, type CareerBout, type CareerStats, type Champion, type ChangeFeedEntry, type ChangeKind, type Compare, type CompareAggregates, type CompareBout, type CredentialConfidence, DEFAULT_BASE_URL, type DissentingJudge, type Envelope, type EventChange, type EventDetail, type EventHeadline, type EventInclude, type EventListInclude, type EventOdds, type EventOddsRow, type EventPickem, type EventRef, type EventStatus, type EventStorylines, type EventSummary, type EventWatch, type Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightInclude, type FightOdds, type FightResult, type FightSearchMethod, type FightSearchRow, type Fighter, type FighterAffiliation, type FighterBout, type FighterCredential, type FighterCredentials, type FighterImage, type FighterInclude, type FighterRef, type FighterSummary, type HeadlineCorner, type Judge, type JudgeColleague, type JudgeLeague, type JudgeScorecardRow, type LeaderboardRow, type MatchmakerCorner, type MatchmakerTag, type Matchup, type Meta, type MethodNormalized, type OddsBlock, type OddsHistoryPoint, type OddsLine, type OddsMovement, type OddsPair, type Org, type OrgDivision, type PickemSplit, type Plan, type Plans, type PowerIndex, type PowerIndexFighter, type PowerIndexMover, type PowerIndexRow, type PowerIndexView, type ProbabilitySource, type PublicSource, type Query, type QueryValue, type RankingDivision, type RankingEntry, type RankingsBoard, type RateLimit, type RecordBookSection, type RecordEntry, type RightsSeries, type Scorecard, type ScorecardRound, type Scorecards, type SplitDecisionRow, type StatMetric, type StatScope, type StatsPanel, type StorylineCorner, type StorylineTag, type Usage, VERSION, type Venue, type WatchProvider, type WebhookEndpoint, type WhosNext, type YearStats, type operations, type paths };
|
|
12942
|
+
export { type Article, type ArticleLocale, type ArticleSummary, type BonusAward, type BonusLedger, type Broadcast, type BroadcastRight, type CareerBout, type CareerStats, type Champion, type ChangeFeedEntry, type ChangeKind, type Compare, type CompareAggregates, type CompareBout, type CredentialConfidence, DEFAULT_BASE_URL, type DissentingJudge, type Envelope, type EventChange, type EventDetail, type EventHeadline, type EventInclude, type EventListInclude, type EventOdds, type EventOddsRow, type EventPickem, type EventRef, type EventStatus, type EventStorylines, type EventSummary, type EventWatch, type Fight, FightAPI, FightAPIError, type FightAPIOptions, type FightInclude, type FightOdds, type FightProps, type FightResult, type FightSearchMethod, type FightSearchRow, type Fighter, type FighterAffiliation, type FighterBout, type FighterCredential, type FighterCredentials, type FighterImage, type FighterInclude, type FighterRef, type FighterSummary, type HeadlineCorner, type Judge, type JudgeColleague, type JudgeLeague, type JudgeScorecardRow, type LeaderboardRow, type MatchmakerCorner, type MatchmakerTag, type Matchup, type Meta, type MethodNormalized, type OddsBlock, type OddsHistoryPoint, type OddsLine, type OddsMovement, type OddsPair, type Org, type OrgDivision, type PickemSplit, type Plan, type Plans, type PowerIndex, type PowerIndexFighter, type PowerIndexMover, type PowerIndexRow, type PowerIndexView, type ProbabilitySource, type PropLine, type PropMethodCorner, type PropTotalRounds, type PublicSource, type Query, type QueryValue, type RankingDivision, type RankingEntry, type RankingsBoard, type RateLimit, type RecordBookSection, type RecordEntry, type RightsSeries, type Scorecard, type ScorecardRound, type Scorecards, type SplitDecisionRow, type StatMetric, type StatScope, type StatsPanel, type StorylineCorner, type StorylineTag, type Usage, VERSION, type Venue, type WatchProvider, type WebhookEndpoint, type WhosNext, type YearStats, type operations, type paths };
|