Stats

One stat leaderboard

One board from UFCalendar's Record Book rollup (rebuilt daily) for ONE promotion — org is required; there is no cross-promotion board on the API. metric picks the board; its scope decides what a row is: career rows are fighters, single_fight and round rows are PERFORMANCES (one fighter can hold several; fight names the bout and opponent, round_number the round), event rows are CARDS (event, no fighter), division rows are WEIGHT CLASSES (division, no fighter). value is in meta.metric.unit (rate is a 0–1 fraction; seconds, per_minute, per_15_minutes as named); value_secondary is the denominator or context named by meta.metric.secondary (e.g. attempts behind an accuracy, the round of a fastest finish); sample_n is the bouts (or fighters) behind the value. direction is the ranking order, not a verdict. rank is the rollup's own position; equal values are a tie — display_rank and tied say so. Narrow with division, country (ISO-2, fighters of that nationality; population all only — combining it with population=active 400s invalid_filter) or population=active (a bout in the last ~18 months). Boards need a minimum sample, so a narrow slice can 404. Errors: invalid_org, invalid_metric, invalid_division, invalid_country, invalid_population, invalid_filter.

get/v1/stats/leaders

Request

  • Base URL: https://api.ufcalendar.com
  • URL: https://api.ufcalendar.com/v1/stats/leaders
  • Auth: HTTP bearer

Query parameters

org'ufc' | 'pfl' | 'oktagon' | 'bkfc' | 'rizin' required

Launch org slug (required): ufc, pfl, oktagon, bkfc or rizin.

metric'total_fights' | 'wins' | 'decision_wins' | 'title_fight_wins' | 'bonuses' | 'finishes' | 'win_streak' | 'total_fight_seconds' | 'avg_fight_seconds_short' | 'avg_fight_seconds_long' | 'control_time_sec' | 'control_time_pct' | 'sig_strikes_landed' | 'total_strikes_landed' | 'slpm' | 'sapm' | 'striking_differential' | 'sig_strike_accuracy' | 'sig_strike_defense' | 'knockdowns' | 'knockdowns_per_15' | 'knockouts' | 'takedowns_landed' | 'td_avg' | 'takedown_accuracy' | 'takedown_defense' | 'submission_attempts' | 'sub_avg_per_15' | 'submissions' | 'fastest_finish' | 'fastest_knockout' | 'fastest_submission' | 'longest_fight_seconds' | 'most_sig_strikes_fight' | 'most_takedowns_fight' | 'most_knockdowns_fight' | 'longest_control_fight' | 'most_sig_strikes_round' | 'most_takedowns_round' | 'most_knockdowns_round' | 'most_finishes_event' | 'most_knockouts_event' | 'shortest_card_seconds' | 'finish_rate' | 'ko_rate' | 'sub_rate' | 'decision_rate' | 'avg_fight_seconds' required

Board metric slug.

division'strawweight' | 'flyweight' | 'bantamweight' | 'featherweight' | 'lightweight' | 'welterweight' | 'super-welterweight' | 'middleweight' | 'light-heavyweight' | 'heavyweight' | 'super-heavyweight' | 'womens-strawweight' | 'womens-flyweight' | 'womens-bantamweight' | 'womens-featherweight' | 'atomweight' | 'ironweight'

One weight class.

population'all' | 'active'

active = fighters with a bout in the last ~18 months.

countrystring

ISO-3166 alpha-2 nationality; population all only.

limitinteger

Response

Board rows, best first

Changes

No recorded changes to this operation across all 1 revision of this API.