Skip to main content

MMA Data Dictionary

Below you will find a list of all data points that are contained within each feed that we offer. If any of the information provided below is unclear, or if you have a specific question, please contact support.

Go to our developer portal for a full list of operations including deprecated, legacy and test endpoints.

All dates & times are in US Eastern Time.

Filter by a Subfeed...
Download CSV
BettingEntityMetadata (From 2022)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
RecordIdinteger (32)NOT NULLNoThe ID of the record. Unique only within the same entity type (i.e. BettingMarketType IDs have commonality with BettingBetType IDs)
Namestring (100)NOT NULLNoDenotes the name of the type (e.g. Betting Market Type, Betting Event Type, Betting Period Type)
Activebool (32)NULLNoWhether or not this market is currently is use
BettingEntityMetadataCollection (From 2022)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
BettingBetTypesBettingEntityMetadata[] (32)NULLNoA list of the bet types that can be found within a market (e.g. Total Significant Strikes Landed; To Win by Unanimous Decision; Moneyline)
BettingMarketTypesBettingEntityMetadata[] (32)NULLNoA list of the possible market types that can be found within a market (e.g. Fight Line; Fighter Prop)
BettingPeriodTypesBettingEntityMetadata[] (32)NULLNoA list of the period types that can be found within a market (e.g. Round 1; Round 2; Full Fight)
BettingEventTypesBettingEntityMetadata[] (32)NULLNoA list of the possible betting events
BettingOutcomeTypesBettingEntityMetadata[] (32)NULLNoA list of the possible BettingOutcomeTypes (e.g. Under; Over; X+; etc.)
BettingEvent (From 2022)
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
BettingEventIdinteger (32)NOT NULLNoThe unique ID associated with the betting event
Namestring (250)NOT NULLNoThe name of the betting event
BettingEventTypeIDinteger (32)NOT NULLNoThe ID associated with the type of betting event
BettingEventTypestring (100)NOT NULLNoIndicates the type of betting event
StartDatedate (32)NOT NULLNoThe start date of this betting event
Createddate (32)NOT NULLNoThe timestamp of when the betting event was created
Updateddate (32)NOT NULLNoThe last updated date of this betting event (in US Eastern Time)
FightIdinteger (32)NULLNoThe unique ID of the fight related to the betting event
BettingMarketsBettingMarket[] (32)NOT NULLNoA list of possible betting markets found within the betting event
BettingMarket (From 2022)
Available Endpoints
NameType (Size)NullableScrambledDescription
BettingMarketIDinteger (32)NOT NULLNoThe unique ID associated with the betting market
BettingEventIDint (32)NOT NULLNoThe unique ID associated with the betting event
BettingMarketTypeIDinteger (32)NOT NULLYesID that distinguishes the different types of Market Types
BettingMarketTypestring (100)NOT NULLYesThe name of the Market Type (e.g. Fighter Prop, Fight Prop, etc.)
BettingBetTypeIDinteger (32)NOT NULLYesThe ID associated with the name of the bet type within a market
BettingBetTypestring (100)NOT NULLYesThe name of the bet type within a market
BettingPeriodTypeIDinteger (32)NOT NULLYesThe BettingPeriodTypeID of this type of market which we can result
BettingPeriodTypestring (100)NOT NULLYesThe BettingPeriodType of this market (e.g. Full Fight; 1st Round, etc.)
Namestring (250)NOT NULLNoThe name of the betting market
FighterIdinteger (32)NULLYesThe unique ID of the fighter tied to this market (where applicable)
FighterNamestring (100)NOT NULLYesThe full name of the fighter tied to this market (where applicable)
Createddate (32)NOT NULLNoThe timestamp of when this market was created
Updateddate (32)NOT NULLNoThe updated timestamp of this market (in US Eastern Time)
AvailableSportsbooksSportsbook[] (32)NOT NULLNoThe sportsbooks which have had odds in this market
AnyBetsAvailablebool (32)NOT NULLNoA field that returns "True" if there are any available bets to make within the market in question. If there are no bets available to make, the field returns "False"
BettingOutcomesBettingOutcome[] (32)NOT NULLNoThe list of betting outcomes from each sportsbook in the market
ConsensusOutcomesConsensusOutcome[] (32)NULLNoThe single set of consensus outcomes of this market
BettingOutcome (From 2022)
Available Endpoints
NameType (Size)NullableScrambledDescription
BettingOutcomeIDinteger (32)NOT NULLNoThe unique ID of this outcome
BettingMarketIDinteger (32)NOT NULLNoThe unique ID associated with the betting market
SportsbookSportsbook (32)NOT NULLNoThe sportsbook offering this outcome for betting
BettingOutcomeTypeIDinteger (32)NULLYesThe BettingOutcomeTypeID of this outcome
BettingOutcomeTypestring (100)NULLYesThe name of Betting Outcome Type (e.g. Under; Over; etc.)
PayoutAmericaninteger (32)NOT NULLYesThe American odds payout
PayoutDecimaldecimal (32)NULLYesThe decimal odds payout
Valuedecimal (32)NULLYesThe number/handicap associated with the outcome (spread/total/etc.,)
Participantstring (100)NULLNoThe name of the participant (typically team or player) associated with the outcome. NOTE: This is provided by the sportsbook. In the case of Player odds, we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks.
IsAvailablebool (32)NOT NULLNoIndicates if this outcome is available for betting as of the last update
IsAlternatebool (32)NULLNoIndicates if this is an alternate value or the core value
Createddate (32)NOT NULLNoThe timestamp of when the betting outcome was created
Updateddate (32)NOT NULLNoThe last updated timestamp of the outcome (in US Eastern Time)
FighterIdinteger (32)NULLYesThe unique ID of the fighter tied to this betting outcome (where applicable)
SportsbookUrlstring (250)NULLNoThe URL for the sportsbook event
Unlisteddatetime (32)NULLNoThe datetime the outcome was unlisted (no longer available for bets)
CareerStat
Available Endpoints
NameType (Size)NullableScrambledDescription
FighterIdinteger (32)NULLNoThe unique ID of this fighter
FirstNamestring (50)NULLNoThe first name of the fighter
LastNamestring (50)NULLNoThe last name of the fighter
SigStrikesLandedPerMinutedecimal (32)NULLYesSignificant strikes landed per minute over the fighter's career
SigStrikeAccuracydecimal (32)NULLYesSignificant strikes landed divided by strikes attempted over the fighter's career
TakedownAveragedecimal (32)NULLYesAverage takedowns landed per 15 minutes in the fighter's career
SubmissionAveragedecimal (32)NULLYesAverage number of submissions attempted per 15 minutes in the fighter's career
KnockoutPercentagedecimal (32)NULLYesThe percentage of wins ending in a knockout by the fighter
TechnicalKnockoutPercentagedecimal (32)NULLYesPercentage of wins ending by TKO in the fighter's career
DecisionPercentagedecimal (32)NULLYesThe percentage of wins ending in a decision by the fighter in their career
ConsensusOutcome (From 2022)
Available Endpoints
NameType (Size)NullableScrambledDescription
NumberOfSportsbooksinteger (32)NOT NULLNoThe number of sportsbooks odds that went into creating this consensus outcome
BettingOutcomeIDinteger (32)NOT NULLNoThe unique ID of this outcome
BettingMarketIDinteger (32)NOT NULLNoThe unique ID associated with the betting market
SportsbookSportsbook (32)NOT NULLNoThe sportsbook offering this outcome for betting
BettingOutcomeTypeIDinteger (32)NULLYesThe BettingOutcomeTypeID of this outcome
BettingOutcomeTypestring (100)NULLYesThe name of Betting Outcome Type (e.g. Under; Over; etc.)
PayoutAmericaninteger (32)NOT NULLYesThe American odds payout
PayoutDecimaldecimal (32)NULLYesThe decimal odds payout
Valuedecimal (32)NULLYesThe number/handicap associated with the outcome (spread/total/etc.,)
Participantstring (100)NULLNoThe name of the participant (typically team or player) associated with the outcome. NOTE: This is provided by the sportsbook. In the case of Player odds, we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks.
IsAvailablebool (32)NOT NULLNoIndicates if this outcome is available for betting as of the last update
IsAlternatebool (32)NULLNoIndicates if this is an alternate value or the core value
Createddate (32)NOT NULLNoThe timestamp of when the Consensus outcome was created
Updateddate (32)NOT NULLNoThe last updated date of the outcome (in US Eastern Time)
FighterIdinteger (32)NULLYesThe unique ID of the fighter tied to this Consensus outcome (where applicable)
SportsbookUrlstring (250)NULLNoThe URL for the sportsbook event
Unlisteddatetime (32)NULLNoThe datetime the outcome was unlisted (i.e. no longer available for bets)
Event
Available Endpoints
NameType (Size)NullableScrambledDescription
EventIdinteger (32)NOT NULLNoThe unique ID of this event
LeagueIdinteger (32)NOT NULLNoThe unique ID of this event's MMA league
Namestring (100)NULLNoThe full name of the event
ShortNamestring (50)NULLNoThe short name of the event
Seasoninteger (32)NULLNoThe season the event took place
DaydateNULLNoThe date of the event
DateTimedatetimeNULLNoThe start time and day of the event
Statusstring (50)NULLNoIndicates the event's status. Possible values include: Scheduled, In Progress, Final, Suspended, Postponed, Canceled
ActivebooleanNULLNoIndicates if the event is active
EventDetail
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
FightsFight[]NULLNoThe details of the fights
EventIdinteger (32)NOT NULLNoThe unique ID of this event
LeagueIdinteger (32)NOT NULLNoThe unique ID of this event's MMA league
Namestring (100)NULLNoThe full name of the event
ShortNamestring (50)NULLNoThe short name of the event
Seasoninteger (32)NULLNoThe season the event took place
DaydateNULLNoThe date of the event
DateTimedatetimeNULLNoThe start time and day of the event
Statusstring (50)NULLNoIndicates the event's status. Possible values include: Scheduled, In Progress, Final, Suspended, Postponed, Canceled
ActivebooleanNULLNoIndicates if the event is active
EventOdds
Available Endpoints
NameType (Size)NullableScrambledDescription
EventEventNOT NULLNoThe Event as an object - including the EventID, LeagueID, Name (and ShortName)of the Event, Season, Day, DateTime, & Status
FightOddsFightOdds[]NULLNoThe Event's collection of FightOdds
Fight
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
FightIdinteger (32)NOT NULLNoThe unique ID of this fight
Orderinteger (32)NULLNoThe order of this fight on the fight card
Statusstring (50)NULLYesIndicates the event's status. Possible values include: Scheduled; In Progress; Final; End of Round; Canceled; Walkouts; Intros, Pre-fight; and NULL
WeightClassstring (50)NULLYesThe weight class this fight is taking place at
CardSegmentstring (50)NULLYesWhat segment of the card this fight is on (Main Card, Prelims, Early Prelims)
Refereestring (50)NULLYesThe number of referee for this fight
Roundsinteger (32)NULLYesThe number of rounds for this fight
ResultClockinteger (32)NULLYesThe time on the clock in seconds when the fight ended
ResultRoundinteger (32)NULLYesThe round when the fight ended
ResultTypestring (50)NULLYesThe way in which this fight ended (Possible values: No Contest; Decision; Submission; KO/TKO; Decision - Majority; Decision - Unanimous; Decision - Split; Draw; DQ)
WinnerIdinteger (32)NULLYesThe unique ID of the fighter who won the fight
FightersFighterInfo[]NULLNoThe fighters competing in this fight and their info (FighterID, FirstName, LastName, PreFightWins, PreFightLosses, PreFightDraws, PreFightNoContests, Winner, Moneyline)
ActivebooleanNULLNoIndicates the fight is still active
IsClosedboolNOT NULLNoIndicates whether the fight is over and the winner has been verified and closed out. Note: it is recommend for bet resulting to use IsClosed = True rather than simply Final fight status
FightBasic (From 2024)
Available Endpoints
NameType (Size)NullableScrambledDescription
FightIdinteger (32)NOT NULLNoThe unique ID of this fight
Orderinteger (32)NULLNoThe order of this fight on the fight card
Statusstring (50)NULLYesIndicates the fight's status. Possible values: Scheduled; Pre-fight; Walkouts; Intros; In Progress; End of Round; Final; Canceled; and NULL
WeightClassstring (50)NULLYesThe weight class this fight is taking place at
CardSegmentstring (50)NULLYesWhat segment of the card this fight is on (Main Card, Prelims, Early Prelims)
Refereestring (50)NULLYesThe number of referee for this fight
Roundsinteger (32)NULLYesThe number of rounds for this fight
ResultClockinteger (32)NULLYesThe time on the clock in seconds when the fight ended
ResultRoundinteger (32)NULLYesThe round when the fight ended
ResultTypestring (50)NULLYesThe way in which this fight ended (Possible values: No Contest; Decision; Submission; KO/TKO; Decision - Majority; Decision - Unanimous; Decision - Split; Draw; DQ)
WinnerIdinteger (32)NULLYesThe unique ID of the fighter who won the fight
ActivebooleanNULLNoIndicates the fight is still active
FightDetail
Available Endpoints
NameType (Size)NullableScrambledDescription
FightStatsFightStat[]NULLNoStats for each fighter in this fight
FightIdinteger (32)NOT NULLNoThe unique ID of this fight
Orderinteger (32)NULLNoThe order of this fight on the fight card
Statusstring (50)NULLYesIndicates the fight's status. Possible values: Scheduled; Pre-fight; Walkouts; Intros; In Progress; End of Round; Final; Canceled; and NULL
WeightClassstring (50)NULLYesThe weight class this fight is taking place at
CardSegmentstring (50)NULLYesWhat segment of the card this fight is on (Main Card, Prelims, Early Prelims)
Refereestring (50)NULLYesThe number of referee for this fight
Roundsinteger (32)NULLYesThe number of rounds for this fight
ResultClockinteger (32)NULLYesThe time on the clock in seconds when the fight ended
ResultRoundinteger (32)NULLYesThe round when the fight ended
ResultTypestring (50)NULLYesThe way in which this fight ended (Possible values: No Contest; Decision; Submission; KO/TKO; Decision - Majority; Decision - Unanimous; Decision - Split; Draw; DQ)
WinnerIdinteger (32)NULLYesThe unique ID of the fighter who won the fight
FightersFighterInfo[]NULLNoThe fighters competing in this fight and their info (FIghterID, FirstName, LastName, PreFightWins, PreFightLosses, PreFightDraws, PreFightNoContests, Winner, Moneyline)
ActivebooleanNULLNoIndicates the fight is still active
IsClosedboolNOT NULLNoIndicates whether the fight is over and the winner has been verified and closed out. Note: it is recommend for bet resulting to use IsClosed = True rather than simply Final fight status
Fighter
Available Endpoints
NameType (Size)NullableScrambledDescription
FighterIdinteger (32)NOT NULLNoThe unique ID of this fighter
FirstNamestring (50)NULLNoThe first name of the fighter
LastNamestring (50)NULLNoThe last name of the fighter
Nicknamestring (50)NULLNoThe nickname of the fighter
WeightClassstring (50)NULLYesThe fighter's weight class
BirthDatedatetime (32)NULLNoThe fighter's date of birth
Heightdecimal (32)NULLYesThe height of the fighter
Weightdecimal (32)NULLYesThe fighter's weight in pounds (lbs.)
Reachdecimal (32)NULLYesThe fighter's reach
Winsinteger (32)NULLYesThe total number of wins the fighter has in their career
Lossesinteger (32)NULLYesTotal number of losses by the fighter in their career
Drawsinteger (32)NULLYesThe total number of fights in the fighter's career that ended in a draw
NoContestsinteger (32)NULLYesThe total number of fights in the fighter's career that ended in a no contest
TechnicalKnockoutsinteger (32)NULLYesTotal technical knockout (TKO) wins by the fighter in their career
TechnicalKnockoutLossesinteger (32)NULLYesTotal technical knockout (TKO) losses by the fighter in their career
Submissionsinteger (32)NULLYesTotal submission wins by the fighter in their career
SubmissionLossesinteger (32)NULLYesTotal submission losses by the fighter in their career
TitleWinsinteger (32)NULLYesTotal title fight wins by the fighter in their career
TitleLossesinteger (32)NULLYesTotal title fight losses by the fighter in their career
TitleDrawsinteger (32)NULLYesThe fighter's title draws
CareerStatsCareerStat (32)NULLNoThe fighter's overall career stats
FighterBasic
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
FighterIdinteger (32)NOT NULLNoThe unique ID of this fighter
FirstNamestring (50)NULLNoThe first name of the fighter
LastNamestring (50)NULLNoThe last name of the fighter
Nicknamestring (50)NULLNoThe nickname of the fighter
WeightClassstring (50)NULLNoThe fighter's weight class
BirthDatedatetime (32)NULLNoThe fighter's date of birth
Heightdecimal (32)NULLNoThe height of the fighter
Weightdecimal (32)NULLNoThe fighter's weight in pounds (lbs.)
Reachdecimal (32)NULLNoThe fighter's reach
Winsinteger (32)NULLNoThe total number of wins the fighter has in their career
Lossesinteger (32)NULLNoTotal number of losses by the fighter in their career
Drawsinteger (32)NULLNoThe total number of fights in the fighter's career that ended in a draw
NoContestsinteger (32)NULLNoThe total number of fights in the fighter's career that ended in a no contest
TechnicalKnockoutsinteger (32)NULLNoTotal technical knockout (TKO) wins by the fighter in their career
TechnicalKnockoutLossesinteger (32)NULLNoTotal technical knockout (TKO) losses by the fighter in their career
Submissionsinteger (32)NULLNoTotal submission wins by the fighter in their career
SubmissionLossesinteger (32)NULLNoTotal submission losses by the fighter in their career
TitleWinsinteger (32)NULLNoTotal title fight wins by the fighter in their career
TitleLossesinteger (32)NULLNoTotal title fight losses by the fighter in their career
TitleDrawsinteger (32)NULLNoThe fighter's title draws
FighterInfo
Available Endpoints
NameType (Size)NullableScrambledDescription
FighterIdinteger (32)NULLNoThe unique ID of this fighter
FirstNamestring (50)NULLNoThe first name of the fighter
LastNamestring (50)NULLNoThe last name of the fighter
PreFightWinsinteger (32)NULLYesThe fighter's win total prior to the fight
PreFightLossesinteger (32)NULLYesThe fighter's loss total prior to the fight
PreFightDrawsinteger (32)NULLYesThe fighter's draw total prior to the fight
PreFightNoContestsinteger (32)NULLYesThe fighter's no contest total prior to the fight
WinnerbooleanNULLYesIndicates if this fighter won the fight
Moneylineinteger (32)NULLYesMoneyline for the fighter's odds to win the fight
ActivebooleanNULLNoIndicates the fighter is still listed for this fight
FightOdds
Available Endpoints
NameType (Size)NullableScrambledDescription
FightOddIdinteger (32)NULLNoThe unique ID of this FIghtOdd
SportsbookIdinteger (32)NULLNoThe unique ID of this Sportsbook
SportsbookNamestring (50)NULLNoThe name of Sportsbook
EventIdinteger (32)NULLNoThe unique ID of this event
FightIdinteger (32)NULLNoThe unique ID of this Fight
FighterAFighterNULLNoThe details of Fighter A
FighterBFighterNULLNoThe details of Fighter B
FighterAMoneylineinteger (32)NULLYesThe sportsbook's moneyline for Fighter A
FighterBMoneylineinteger (32)NULLYesThe sportsbook's moneyline for Fighter B
CreateddatetimeNULLNoThe timestamp of when these odds were first created based on US Eastern Time
UpdateddatetimeNULLNoThe timestamp of when these odds were last updated (in US Eastern Time)
SportsbookUrlstring (500)NULLYesThe URL for the sportsbook event
FightStat
Available Endpoints
NameType (Size)NullableScrambledDescription
FighterIdinteger (32)NULLNoThe unique ID of this fighter
FirstNamestring (50)NULLNoThe first name of the fighter
LastNamestring (50)NULLNoThe last name of the fighter
WinnerbooleanNULLYesIndicates if this fighter won the fight
FantasyPointsdecimal (32)NULLYesTotal fantasy points scored by the fighter in the fight
FantasyPointsDraftKingsdecimal (32)NULLYesTotal DraftKings fantasy points scored by the fighter in the fight
Knockdownsdecimal (32)NULLYesThe total number of official knockdowns by the fighter to the opponent
TotalStrikesAttempteddecimal (32)NULLYesTotal number of all strikes attempted by the fighter in this fight
TotalStrikesLandeddecimal (32)NULLYesTotal number of all strikes landed by the fighter in this fight
SigStrikesAttempteddecimal (32)NULLYesTotal number of strikes attempted that officials deem significant strikes by the fighter in this fight
SigStrikesLandeddecimal (32)NULLYesTotal number of strikes landed that officials deem significant strikes by the fighter in this fight
TakedownsAttempteddecimal (32)NULLYesTotal number of takedowns attempted by the fighter in this fight
TakedownsLandeddecimal (32)NULLYesTotal number of takedowns landed by the fighter in this fight
TakedownsSlamsdecimal (32)NULLYesTotal number of takedowns that were a result of forcefully slamming opponent to ground by the fighter in this fight
TakedownAccuracydecimal (32)NULLYesTotal number of takedowns landed divided by number of takedowns attempted
Advancesdecimal (32)NULLYesTotal number of advances to half guard, side control, mount, or back control
Reversalsdecimal (32)NULLYesTransitions performed by countering your opponents transition and giving fighter the offensive advantage.
Submissionsdecimal (32)NULLYesTotal number of submissions or technical submissions attempted
SlamRatedecimal (32)NULLYesNumber of takedown slams landed divided by number of takedowns attempted
TimeInControldecimal (32)NULLYesNumber of seconds fighter deemed in control by officials
FirstRoundWinbooleanNULLYesIndicates if this fighter won the fight in the first round
SecondRoundWinbooleanNULLYesIndicates if this fighter won the fight in the second round
ThirdRoundWinbooleanNULLYesIndicates if this fighter won the fight in the third round
FourthRoundWinbooleanNULLYesIndicates if this fighter won the fight in the fourth round
FifthRoundWinbooleanNULLYesIndicates if this fighter won the fight in the fifth round
DecisionWinbooleanNULLYesIndicates if this fighter won the fight by decision
League
Available Endpoints
This table is used in the following endpoints:
NameType (Size)NullableScrambledDescription
LeagueIdinteger (32)NOT NULLNoThe unique ID of the MMA league
Namestring (50)NOT NULLNoThe name of this MMA league
Keystring (50)NOT NULLNoThe league abbreviation of the MMA league
Sportsbook
Available Endpoints
NameType (Size)NullableScrambledDescription
SportsbookIDint (32)NOT NULLNoThe unique ID of the sportsbook
Namestring (50)NOT NULLYesThe name of the sportsbook
Contact Us