@ufcalendar/sdk 0.8.0 → 0.8.2
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 +13 -3
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +274 -16
- package/dist/index.d.ts +274 -16
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +15 -8
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.2";
|
|
1698
1742
|
|
|
1699
1743
|
/**
|
|
1700
1744
|
* This file was auto-generated by openapi-typescript.
|
|
@@ -3229,7 +3273,7 @@ interface paths {
|
|
|
3229
3273
|
};
|
|
3230
3274
|
/**
|
|
3231
3275
|
* 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.
|
|
3276
|
+
* @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
3277
|
*/
|
|
3234
3278
|
get: {
|
|
3235
3279
|
parameters: {
|
|
@@ -3340,7 +3384,8 @@ interface paths {
|
|
|
3340
3384
|
* "since": "2025-11-15T23:00:00.000Z"
|
|
3341
3385
|
* },
|
|
3342
3386
|
* "points": 1,
|
|
3343
|
-
* "updated_at": "2025-11-15T23:00:00.000Z"
|
|
3387
|
+
* "updated_at": "2025-11-15T23:00:00.000Z",
|
|
3388
|
+
* "props": null
|
|
3344
3389
|
* }
|
|
3345
3390
|
* ]
|
|
3346
3391
|
* },
|
|
@@ -4422,7 +4467,9 @@ interface paths {
|
|
|
4422
4467
|
};
|
|
4423
4468
|
/**
|
|
4424
4469
|
* 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.
|
|
4470
|
+
* @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.
|
|
4471
|
+
*
|
|
4472
|
+
* `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
4473
|
*/
|
|
4427
4474
|
get: {
|
|
4428
4475
|
parameters: {
|
|
@@ -4529,7 +4576,136 @@ interface paths {
|
|
|
4529
4576
|
* "since": "2026-08-18T22:50:43.418Z"
|
|
4530
4577
|
* },
|
|
4531
4578
|
* "points": 57,
|
|
4532
|
-
* "updated_at": "2026-08-29T10:50:34.350Z"
|
|
4579
|
+
* "updated_at": "2026-08-29T10:50:34.350Z",
|
|
4580
|
+
* "props": {
|
|
4581
|
+
* "method": {
|
|
4582
|
+
* "a": {
|
|
4583
|
+
* "ko": {
|
|
4584
|
+
* "yes": {
|
|
4585
|
+
* "american": 411,
|
|
4586
|
+
* "decimal": 5.11,
|
|
4587
|
+
* "implied_probability": 0.1957
|
|
4588
|
+
* },
|
|
4589
|
+
* "no": null,
|
|
4590
|
+
* "fair_probability": 0.1649,
|
|
4591
|
+
* "sources": 12,
|
|
4592
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4593
|
+
* },
|
|
4594
|
+
* "sub": {
|
|
4595
|
+
* "yes": {
|
|
4596
|
+
* "american": 1322,
|
|
4597
|
+
* "decimal": 14.22,
|
|
4598
|
+
* "implied_probability": 0.0703
|
|
4599
|
+
* },
|
|
4600
|
+
* "no": null,
|
|
4601
|
+
* "fair_probability": 0.0593,
|
|
4602
|
+
* "sources": 12,
|
|
4603
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4604
|
+
* },
|
|
4605
|
+
* "dec": {
|
|
4606
|
+
* "yes": {
|
|
4607
|
+
* "american": 290,
|
|
4608
|
+
* "decimal": 3.9,
|
|
4609
|
+
* "implied_probability": 0.2564
|
|
4610
|
+
* },
|
|
4611
|
+
* "no": {
|
|
4612
|
+
* "american": -425,
|
|
4613
|
+
* "decimal": 1.235,
|
|
4614
|
+
* "implied_probability": 0.8095
|
|
4615
|
+
* },
|
|
4616
|
+
* "fair_probability": 0.216,
|
|
4617
|
+
* "sources": 11,
|
|
4618
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4619
|
+
* }
|
|
4620
|
+
* },
|
|
4621
|
+
* "b": {
|
|
4622
|
+
* "ko": {
|
|
4623
|
+
* "yes": {
|
|
4624
|
+
* "american": 462,
|
|
4625
|
+
* "decimal": 5.62,
|
|
4626
|
+
* "implied_probability": 0.1779
|
|
4627
|
+
* },
|
|
4628
|
+
* "no": null,
|
|
4629
|
+
* "fair_probability": 0.1499,
|
|
4630
|
+
* "sources": 12,
|
|
4631
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4632
|
+
* },
|
|
4633
|
+
* "sub": {
|
|
4634
|
+
* "yes": {
|
|
4635
|
+
* "american": 1078,
|
|
4636
|
+
* "decimal": 11.78,
|
|
4637
|
+
* "implied_probability": 0.0849
|
|
4638
|
+
* },
|
|
4639
|
+
* "no": null,
|
|
4640
|
+
* "fair_probability": 0.0715,
|
|
4641
|
+
* "sources": 12,
|
|
4642
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4643
|
+
* },
|
|
4644
|
+
* "dec": {
|
|
4645
|
+
* "yes": {
|
|
4646
|
+
* "american": 149,
|
|
4647
|
+
* "decimal": 2.49,
|
|
4648
|
+
* "implied_probability": 0.4016
|
|
4649
|
+
* },
|
|
4650
|
+
* "no": null,
|
|
4651
|
+
* "fair_probability": 0.3384,
|
|
4652
|
+
* "sources": 11,
|
|
4653
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4654
|
+
* }
|
|
4655
|
+
* }
|
|
4656
|
+
* },
|
|
4657
|
+
* "total_rounds": [
|
|
4658
|
+
* {
|
|
4659
|
+
* "line": 1.5,
|
|
4660
|
+
* "over": {
|
|
4661
|
+
* "american": -386,
|
|
4662
|
+
* "decimal": 1.259,
|
|
4663
|
+
* "implied_probability": 0.7942
|
|
4664
|
+
* },
|
|
4665
|
+
* "under": {
|
|
4666
|
+
* "american": 258,
|
|
4667
|
+
* "decimal": 3.58,
|
|
4668
|
+
* "implied_probability": 0.2793
|
|
4669
|
+
* },
|
|
4670
|
+
* "fair_probability_over": 0.7398,
|
|
4671
|
+
* "sources": 4,
|
|
4672
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4673
|
+
* },
|
|
4674
|
+
* {
|
|
4675
|
+
* "line": 2.5,
|
|
4676
|
+
* "over": {
|
|
4677
|
+
* "american": -193,
|
|
4678
|
+
* "decimal": 1.518,
|
|
4679
|
+
* "implied_probability": 0.6587
|
|
4680
|
+
* },
|
|
4681
|
+
* "under": {
|
|
4682
|
+
* "american": 153,
|
|
4683
|
+
* "decimal": 2.53,
|
|
4684
|
+
* "implied_probability": 0.3953
|
|
4685
|
+
* },
|
|
4686
|
+
* "fair_probability_over": 0.625,
|
|
4687
|
+
* "sources": 17,
|
|
4688
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4689
|
+
* }
|
|
4690
|
+
* ],
|
|
4691
|
+
* "distance": {
|
|
4692
|
+
* "yes": {
|
|
4693
|
+
* "american": -160,
|
|
4694
|
+
* "decimal": 1.625,
|
|
4695
|
+
* "implied_probability": 0.6154
|
|
4696
|
+
* },
|
|
4697
|
+
* "no": {
|
|
4698
|
+
* "american": 123,
|
|
4699
|
+
* "decimal": 2.23,
|
|
4700
|
+
* "implied_probability": 0.4484
|
|
4701
|
+
* },
|
|
4702
|
+
* "fair_probability": 0.5785,
|
|
4703
|
+
* "sources": 11,
|
|
4704
|
+
* "recorded_at": "2026-08-29T07:00:00.000Z"
|
|
4705
|
+
* },
|
|
4706
|
+
* "closing": true,
|
|
4707
|
+
* "updated_at": "2026-08-29T07:00:00.000Z"
|
|
4708
|
+
* }
|
|
4533
4709
|
* },
|
|
4534
4710
|
* "meta": {
|
|
4535
4711
|
* "note": "UFCalendar consensus line across the sportsbooks we track (book identities are not exposed). Information only, not betting advice.",
|
|
@@ -5665,7 +5841,7 @@ interface paths {
|
|
|
5665
5841
|
};
|
|
5666
5842
|
/**
|
|
5667
5843
|
* 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 widest sample UFCalendar holds, with `basis: { bouts, orgs, source, scope }` stating exactly which bouts it averages over (e.g. 7 UFC bouts, or 18 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.
|
|
5844
|
+
* @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 widest sample UFCalendar holds (the `pro-mma` panel: every promotion; `tracked` for a fighter with no MMA career, e.g. a Muay Thai athlete), with `basis: { bouts, orgs, source, scope }` stating exactly which bouts it averages over (e.g. 7 UFC bouts, or 18 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
5845
|
*
|
|
5670
5846
|
* `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
5847
|
*
|
|
@@ -5726,6 +5902,15 @@ interface paths {
|
|
|
5726
5902
|
* "team": "Chute Boxe Diego Lima",
|
|
5727
5903
|
* "birthplace": "Guarujá, Brazil",
|
|
5728
5904
|
* "records": {
|
|
5905
|
+
* "pro_mma": {
|
|
5906
|
+
* "value": "37-11-0 (1 NC)",
|
|
5907
|
+
* "wins": 37,
|
|
5908
|
+
* "losses": 11,
|
|
5909
|
+
* "draws": 0,
|
|
5910
|
+
* "no_contests": 1,
|
|
5911
|
+
* "source": "public-records",
|
|
5912
|
+
* "scope": "pro-mma"
|
|
5913
|
+
* },
|
|
5729
5914
|
* "ufc": {
|
|
5730
5915
|
* "value": "25-11-0 (1 NC)",
|
|
5731
5916
|
* "wins": 25,
|
|
@@ -5760,12 +5945,25 @@ interface paths {
|
|
|
5760
5945
|
* "orgs": [
|
|
5761
5946
|
* "ufc"
|
|
5762
5947
|
* ],
|
|
5763
|
-
* "source": "
|
|
5764
|
-
* "scope": "
|
|
5948
|
+
* "source": "ufcalendar",
|
|
5949
|
+
* "scope": "pro-mma"
|
|
5765
5950
|
* }
|
|
5766
5951
|
* },
|
|
5767
5952
|
* "career_stats": [
|
|
5768
5953
|
* {
|
|
5954
|
+
* "scope": "pro-mma",
|
|
5955
|
+
* "source": "public-records",
|
|
5956
|
+
* "record": "37-11-0 (1 NC)",
|
|
5957
|
+
* "slpm": "3.23",
|
|
5958
|
+
* "str_acc": "55%",
|
|
5959
|
+
* "sapm": "3.05",
|
|
5960
|
+
* "str_def": null,
|
|
5961
|
+
* "td_avg": "2.29",
|
|
5962
|
+
* "td_acc": "39%",
|
|
5963
|
+
* "td_def": "54%",
|
|
5964
|
+
* "sub_avg": null
|
|
5965
|
+
* },
|
|
5966
|
+
* {
|
|
5769
5967
|
* "scope": "ufc-only",
|
|
5770
5968
|
* "source": "ufc-stats",
|
|
5771
5969
|
* "record": "25-11-0 (1 NC)",
|
|
@@ -6122,7 +6320,7 @@ interface paths {
|
|
|
6122
6320
|
};
|
|
6123
6321
|
/**
|
|
6124
6322
|
* Career statistics
|
|
6125
|
-
* @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. Org-scoped rows (`ufc-only`, `bkfc-only`, `one-only`) are the fighter's record INSIDE that promotion, not a career record: `ufc-only`
|
|
6323
|
+
* @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. A fighter whose records show no MMA career at all (a ONE Muay Thai or kickboxing athlete) carries the every-promotion averages on a `tracked` row (null record) instead of `pro-mma`, because those bouts are not MMA. 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).
|
|
6126
6324
|
*/
|
|
6127
6325
|
get: {
|
|
6128
6326
|
parameters: {
|
|
@@ -9663,7 +9861,7 @@ interface paths {
|
|
|
9663
9861
|
put?: never;
|
|
9664
9862
|
/**
|
|
9665
9863
|
* Register a webhook endpoint
|
|
9666
|
-
* @description Pro+. Body: `{"url": "https://...", "events": ["event.announced", "fight.result", "card.changed", "event.completed", "odds.moved"]}`. Subscribe to `event.announced` and you do not need to poll `/v1/events` to discover new cards — it fires once, within a minute of a card first landing in our data, and carries the same event object the list endpoint returns. `odds.moved` fires when the UFCalendar consensus line on an upcoming bout moves at least 5 implied-probability points on corner a, or the favourite flips, measured against the last line we delivered for that bout (its opening line before the first delivery), so a slow drift arrives once, not per refresh: `data` is `{fight_id, event, fighter_a, fighter_b, odds: {consensus, opening, movement, updated_at}, previous, delta_points_a, direction, favourite_flipped, moved_at}`. Information only, not betting advice. The response contains the signing `secret` ONCE. Every delivery body is `{"id", "type", "data", "sent_at"}` (`WebhookDelivery` schema) — `id` is stable across retries, so deduplicate on it. Deliveries carry `X-UFCalendar-Signature: t=<unix>,v1=<hmac>` where the HMAC-SHA256 input is `"<t>.<rawBody>"`. **Verify the timestamp too**: reject anything where `|now - t|` exceeds 300 seconds, otherwise a captured delivery can be replayed at you forever with a valid HMAC. Delivery is at-least-once — expect a retry roughly every 60s until your endpoint returns 2xx. Endpoints auto-disable after 20 consecutive failures, and you may hold at most 3 active endpoints (409 `endpoint_limit`). Latency: results are dispatched within ~1 minute of the result being recorded. `event.announced` only fires for cards that have not started yet, so archive backfills never reach you as new-card noise. `card.changed` is filtered the same way: a change whose before and after read identically (a venue row re-minted for the same arena, a source dropping a sub-time it never knew) is never delivered, and when a source flip-flops a value we deliver the move and its undo once, not the twentieth repeat. Deliveries are free — they never count against your monthly request quota, only the calls you make to manage endpoints do.
|
|
9864
|
+
* @description Pro+. Body: `{"url": "https://...", "events": ["event.announced", "fight.result", "card.changed", "event.completed", "odds.moved"]}`. Subscribe to `event.announced` and you do not need to poll `/v1/events` to discover new cards — it fires once, within a minute of a card first landing in our data, and carries the same event object the list endpoint returns. `fight.result` fires once per bout within a minute of the result, as `revision` 1, and again as the next revision (`corrected: true`, with the `previous` result) whenever the winner, method, round, time or status is corrected in the 72 h after it — upsert on `fight_id` and keep the highest `revision`. `odds.moved` fires when the UFCalendar consensus line on an upcoming bout moves at least 5 implied-probability points on corner a, or the favourite flips, measured against the last line we delivered for that bout (its opening line before the first delivery), so a slow drift arrives once, not per refresh: `data` is `{fight_id, event, fighter_a, fighter_b, odds: {consensus, opening, movement, updated_at}, previous, delta_points_a, direction, favourite_flipped, moved_at}`. Information only, not betting advice. The response contains the signing `secret` ONCE. Every delivery body is `{"id", "type", "data", "sent_at"}` (`WebhookDelivery` schema) — `id` is stable across retries, so deduplicate on it. Deliveries carry `X-UFCalendar-Signature: t=<unix>,v1=<hmac>` where the HMAC-SHA256 input is `"<t>.<rawBody>"`. **Verify the timestamp too**: reject anything where `|now - t|` exceeds 300 seconds, otherwise a captured delivery can be replayed at you forever with a valid HMAC. Delivery is at-least-once — expect a retry roughly every 60s until your endpoint returns 2xx. Endpoints auto-disable after 20 consecutive failures, and you may hold at most 3 active endpoints (409 `endpoint_limit`). Latency: results are dispatched within ~1 minute of the result being recorded. `event.announced` only fires for cards that have not started yet, so archive backfills never reach you as new-card noise. `card.changed` is filtered the same way: a change whose before and after read identically (a venue row re-minted for the same arena, a source dropping a sub-time it never knew) is never delivered, and when a source flip-flops a value we deliver the move and its undo once, not the twentieth repeat. Deliveries are free — they never count against your monthly request quota, only the calls you make to manage endpoints do.
|
|
9667
9865
|
*/
|
|
9668
9866
|
post: {
|
|
9669
9867
|
parameters: {
|
|
@@ -10709,8 +10907,9 @@ interface components {
|
|
|
10709
10907
|
bouts: number;
|
|
10710
10908
|
/** @description Org slugs those bouts span. */
|
|
10711
10909
|
orgs: string[];
|
|
10712
|
-
/** @description `ufcalendar`
|
|
10910
|
+
/** @description `ufcalendar` for the every-promotion panel, else the `ufc-only` row's source. Both are computed by UFCalendar from per-fight totals. */
|
|
10713
10911
|
source: string;
|
|
10912
|
+
/** @description `pro-mma` (every settled bout with per-fight totals, any promotion) or `ufc-only` (UFC bouts only, Contender Series excluded). */
|
|
10714
10913
|
scope: string;
|
|
10715
10914
|
};
|
|
10716
10915
|
/** @description ONE per-minute panel: the widest sample UFCalendar holds for the fighter. */
|
|
@@ -10754,7 +10953,7 @@ interface components {
|
|
|
10754
10953
|
};
|
|
10755
10954
|
/** @description Raw per-source career row, exactly one per scope. */
|
|
10756
10955
|
CareerStatRow: {
|
|
10757
|
-
/** @description `pro-mma`, `amateur-mma`, `pro-kickboxing`, …, `ufc-only` / `bkfc-only` / `one-only
|
|
10956
|
+
/** @description `pro-mma`, `amateur-mma`, `pro-kickboxing`, …, or `ufc-only` / `bkfc-only` / `one-only`. */
|
|
10758
10957
|
scope: string;
|
|
10759
10958
|
/** @description Who published the record: `ufc-stats` (ufcstats.com), a promotion's own site (`ufc-official`, `bkfc-official`, `one-official`, `oktagon-official`, …), `ufcalendar` (derived by UFCalendar), or `public-records` (the complete multi-promotion career record compiled from public records). */
|
|
10760
10959
|
source: string;
|
|
@@ -11823,7 +12022,62 @@ interface components {
|
|
|
11823
12022
|
*/
|
|
11824
12023
|
since: string;
|
|
11825
12024
|
};
|
|
11826
|
-
/** @description
|
|
12025
|
+
/** @description One prop market's consensus price: the mean, in decimal space, across the sportsbooks we track, converted back to American. */
|
|
12026
|
+
PropLine: {
|
|
12027
|
+
yes: components["schemas"]["OddsLine"];
|
|
12028
|
+
/** @description Null when fewer than two sportsbooks quote the "no" side (method-of-victory props are mostly quoted "yes" only). */
|
|
12029
|
+
no: components["schemas"]["OddsLine"] | null;
|
|
12030
|
+
/** @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. */
|
|
12031
|
+
fair_probability: number | null;
|
|
12032
|
+
/** @description How many sportsbooks backed this price. Book identities are never exposed. */
|
|
12033
|
+
sources: number;
|
|
12034
|
+
/**
|
|
12035
|
+
* Format: date-time
|
|
12036
|
+
* @description When this price was recorded (the last move).
|
|
12037
|
+
*/
|
|
12038
|
+
recorded_at: string;
|
|
12039
|
+
};
|
|
12040
|
+
PropTotalRounds: {
|
|
12041
|
+
/** @description Rounds line (0.5, 1.5, 2.5, 3.5 or 4.5). */
|
|
12042
|
+
line: number;
|
|
12043
|
+
over: components["schemas"]["OddsLine"];
|
|
12044
|
+
/** @description Null when fewer than two sportsbooks quote the under. */
|
|
12045
|
+
under: components["schemas"]["OddsLine"] | null;
|
|
12046
|
+
/** @description Over with the market margin removed (from the over/under pair), 4 places; null without an under. */
|
|
12047
|
+
fair_probability_over: number | null;
|
|
12048
|
+
/** @description How many sportsbooks backed the over. */
|
|
12049
|
+
sources: number;
|
|
12050
|
+
/** Format: date-time */
|
|
12051
|
+
recorded_at: string;
|
|
12052
|
+
};
|
|
12053
|
+
PropMethodCorner: {
|
|
12054
|
+
/** @description This corner wins by KO/TKO. */
|
|
12055
|
+
ko: components["schemas"]["PropLine"] | null;
|
|
12056
|
+
/** @description This corner wins by submission. */
|
|
12057
|
+
sub: components["schemas"]["PropLine"] | null;
|
|
12058
|
+
/** @description This corner wins by decision. */
|
|
12059
|
+
dec: components["schemas"]["PropLine"] | null;
|
|
12060
|
+
};
|
|
12061
|
+
/** @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. */
|
|
12062
|
+
FightProps: {
|
|
12063
|
+
/** @description Method of victory per corner (oriented to the bout's `fighter_a` / `fighter_b`). */
|
|
12064
|
+
method: {
|
|
12065
|
+
a: components["schemas"]["PropMethodCorner"];
|
|
12066
|
+
b: components["schemas"]["PropMethodCorner"];
|
|
12067
|
+
};
|
|
12068
|
+
/** @description Over/under per rounds line, ascending. The line with the most `sources` is the main one. */
|
|
12069
|
+
total_rounds: components["schemas"]["PropTotalRounds"][];
|
|
12070
|
+
/** @description The fight goes the distance (yes) or ends inside it (no). */
|
|
12071
|
+
distance: components["schemas"]["PropLine"] | null;
|
|
12072
|
+
/** @description True once the bout is settled: every price is the last one before the event start. */
|
|
12073
|
+
closing: boolean;
|
|
12074
|
+
/**
|
|
12075
|
+
* Format: date-time
|
|
12076
|
+
* @description When any market here last moved.
|
|
12077
|
+
*/
|
|
12078
|
+
updated_at: string | null;
|
|
12079
|
+
};
|
|
12080
|
+
/** @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. */
|
|
11827
12081
|
FightOdds: {
|
|
11828
12082
|
fight_id: number;
|
|
11829
12083
|
status: components["schemas"]["FightStatus"] | null;
|
|
@@ -11859,8 +12113,10 @@ interface components {
|
|
|
11859
12113
|
* @description When the line last moved (= `consensus.recorded_at`).
|
|
11860
12114
|
*/
|
|
11861
12115
|
updated_at: string | null;
|
|
12116
|
+
/** @description Prop-market consensus (method of victory, total rounds, goes the distance); null when no sportsbooks price props for the bout. */
|
|
12117
|
+
props: components["schemas"]["FightProps"] | null;
|
|
11862
12118
|
};
|
|
11863
|
-
/** @description One bout of a card with its consensus line. Unpriced bouts stay on the list with nulls and `points: 0`. */
|
|
12119
|
+
/** @description One bout of a card with its consensus line and prop markets. Unpriced bouts stay on the list with nulls and `points: 0`. */
|
|
11864
12120
|
EventOddsRow: {
|
|
11865
12121
|
fight_id: number;
|
|
11866
12122
|
status: components["schemas"]["FightStatus"] | null;
|
|
@@ -11888,6 +12144,8 @@ interface components {
|
|
|
11888
12144
|
* @description When the line last moved (= `consensus.recorded_at`).
|
|
11889
12145
|
*/
|
|
11890
12146
|
updated_at: string | null;
|
|
12147
|
+
/** @description Prop-market consensus (method of victory, total rounds, goes the distance); null when no sportsbooks price props for the bout. */
|
|
12148
|
+
props: components["schemas"]["FightProps"] | null;
|
|
11891
12149
|
};
|
|
11892
12150
|
EventOdds: {
|
|
11893
12151
|
event: components["schemas"]["StorylineEvent"];
|
|
@@ -12144,7 +12402,7 @@ interface components {
|
|
|
12144
12402
|
/** @description Delivery id (stable across retries — deduplicate on it). */
|
|
12145
12403
|
id: string;
|
|
12146
12404
|
type: components["schemas"]["WebhookKind"];
|
|
12147
|
-
/** @description `event.announced` / `event.completed`: `{event}` (the list-shape event); `fight.result`: the bout with `event` and `result
|
|
12405
|
+
/** @description `event.announced` / `event.completed`: `{event}` (the list-shape event); `fight.result`: the bout with `event`, `result`, `revision` and `corrected` — `revision` 1 is the first delivery; if the winner, method, round, time or status changes within 72 h of the result, the bout is re-sent as the next revision with `corrected: true` and the `previous` result it replaces (upsert on `fight_id`, keep the highest `revision`); `card.changed`: `{event, change}`; `odds.moved`: `{fight_id, event, fighter_a, fighter_b, odds: {consensus, opening, movement, updated_at}, previous, delta_points_a, direction, favourite_flipped, moved_at}` (UFCalendar consensus line, information only, not betting advice). */
|
|
12148
12406
|
data: {
|
|
12149
12407
|
[key: string]: unknown;
|
|
12150
12408
|
};
|
|
@@ -12671,4 +12929,4 @@ interface components {
|
|
|
12671
12929
|
}
|
|
12672
12930
|
type operations = Record<string, never>;
|
|
12673
12931
|
|
|
12674
|
-
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 };
|
|
12932
|
+
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 };
|