Fighters

Compare two fighters

The tale of the tape in one call. a and b are fighter slugs or ids (a renamed slug is followed and named in meta.resolved); both are required and must differ (400 invalid_query), and each must be on the roster (404 not_found). Returns both bios (the /v1/fighters/{idOrSlug} bio fields plus age), career_stats (the /v1/fighters/{idOrSlug}/stats rows), aggregates per fighter over every completed bout with per-fight totals (fights_analyzed, average and best significant strikes and takedowns, average control time in seconds, and the strike mix: location_pct head/body/leg and position_pct distance/clinch/ground, whole percents, null when nothing was logged), recent_form (the last five settled entries of the merged multi-promotion timeline, /v1/fighters/{idOrSlug}/history rows), win_streak, head_to_head (their previous meetings, from a's side), common_opponents (up to 5: the shared opponent with each fighter's most recent bout against them), booked_bout (the upcoming or live bout between them in a covered promotion, in its stored corner order, or null), prediction (UFCalendar model win probability for that booked bout, oriented to a — UFC only, served only while its corner stamp matches the bout, else null) and power_index (each fighter's UFCalendar Power Index rating, peak and fights rated, and win_probability_a from the two ratings). Model output is information, not betting advice.

get/v1/compare

Request

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

Query parameters

astring required

First fighter: slug (preferred) or numeric id.

bstring required

Second fighter: slug (preferred) or numeric id.

Response

Side-by-side comparison

Changes

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