Versions Compared

Version Old Version 5 New Version 6
Changes made by

Alexandru Iftimiciuc

Alexandru Iftimiciuc

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel7

Feed Match Event

Code Block
{
    "sportId": 10,
    "fixtureId": "9280712",
    "source": "GeniusSports",
    "sequenceId": 433,
    "actionId": 291,
    "isCancelled": false,
    "isConfirmed": true,
    "isModified": false,
}

Element

Type

Description

sportId

integer

Sport identifier (10 for Football)

fixtureId

string

Fixture identifier

source

string

Feed provider identifier

sequenceId

integer

Fixture specific sequence identifier of the match event

actionId

integer

Match action identifier

isCancelled

boolean

Indicates whether the action is cancelled

isConfirmed

boolean

Indicates whether the action is confirmed

isModified

boolean

Indicates whether the action is modified

action

{}

Consists of Match Action data properties

messageTimestampUtc

string($date-time)

Timestamp of the message

Every Match Event has a type inside the “action” field, named after the respective Action. Example for KickOff below, where “KickOff” is replaced for different Actions.

Code Block
"action": { "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.KickOffDto, Betgenius.Sports.Football.Contracts.MatchEvents"

Feed Match Action

Info

NOTE: All Actions inside Feed Match Event include the following additional fields (hence they are not included in the description of every action).

Code Block
"action":
    {
        "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CommentDto, Betgenius.Sports.Football.Contracts.MatchEvents",
        "team": "Away",
        "gameTime": "00:39:47",
        "period": {      
            "number": 1,
            "progressStatus": "InProgress",
            "type": "Regular"
        },
        "utcTimestamp": "2022-06-01T00:00:05.35Z"
    }

Element

Type

Description

team

string($x-extensible-enum)

[ None, Home, Away ]

Team data

gameTime

string($date-span)

Game time data

period

{}

Period in the game data

utcTimestamp

string($date-time)

Timestamp of the message

number

integer($int32)

Period number
Values: 1, 2

progressStatus

string($x-extensible-enum)

[ NotStarted, InProgress, Finished ]

Period progress status

type

string($date-span)

Game time data
Period.Type values: Regular/ExtraTime/PenaltyShootout

Actions 

Info

NOTE: All Feed Match Actions consist of Feed Match Event + Feed Match Action + Action data properties (with some exceptions described below, marked with *) 

Card

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CardDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "type": "Yellow"
    "player": {
        "id": 456683,
        "name": "Dwight Jork"
    }
}

Element

Type

Description

type

string($x-extensible-enum)

[ Unknown, Yellow, SecondYellow, Red ]

Type data

player

{}

Player in card data

id

string

Unique player identifier

name

string

Player name

CardsReliability

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CardsReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",        
    "type": "Yellow",
    "isReliable": false,        
}

Element

Type

Description

type

string($x-extensible-enum)

[ Unknown, Yellow, SecondYellow, Red ]

Type data

isReliable

boolean

Indicates whether Cards related data is reliable

ClockSet

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockSetDto, Betgenius.Sports.Football.Contracts.MatchEvents"      
}

No specific properties. Sets the game clock.

ClockStarted

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockStartedDto, Betgenius.Sports.Football.Contracts.MatchEvents"      
}

No specific properties. Starts the game clock.

ClockStopped

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ClockStoppedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Stops the game clock.

Comment

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CommentDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "text": "Weather: night",
    "messageId": 0,
}

Element

Type

Description

text

string

Text of the comment

messageId

integer

Message identifier

CornerAwarded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerAwardedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isTaken": false
}

Element

Type

Description

isTaken

boolean

Indicates whether the corner is taken

Corner

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "awardedGameTime": "00:43:25",        
}

Element

Type

Description

awardedGameTime

string($date-span)

Time the corner was awarded

CornerRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. There is a risk of a corner.

CornerRiskEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornerRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. The corner risk is ended.

CornersReliability

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.CornersReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isReliable": false,
}

Element

Type

Description

isReliable

boolean

Indicates whether Corners related data is reliable

DangerStateChanged

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.DangerStateChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "state": "Safe",
}

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Indicates the danger state of the game

FreeKick

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.FreeKickDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "state": "Safe",
}

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Indicates the dangers state of the game when the free kick is awarded

Goal

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.GoalDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isOwn": false,
    "penalty": true,
    "assistingPlayer": null,
    "player": {
        "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PlayerDto, Betgenius.Sports.Football.Contracts.MatchEvents",
        "Id": "1226671",
        "Name": "De la Rosa, R"
    }
}

Element

Type

Description

isOwn

boolean

Indicates if the goal is own goal

penalty

boolean

Indicates if the goal was scored from penalty

assistingPlayer

{}

Player that assisted for the goal (not supported)

id

string

Unique player identifier

name

string

Player name

GoalKick

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.GoalKickDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Goal kick is taken.

GoalsReliability

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.GoalsReliabilityDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "isReliable": false,
}

Element

Type

Description

isReliable

boolean

Indicates whether Goals related data is reliable

KickOff

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.KickOffDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Kick-off.

Lineup

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.LineupDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "lineup": {
        "$values": [
            {
                "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.LineupInfoDto, Betgenius.Sports.Football.Contracts.MatchEvents",
                "id": "1256517",
                "name": "Cuesta, W",
                "firstName": "William",
                "lastName": "Cuesta",
                "playerStatus": "Starter",
                "position": "GoalKeeper",
                "shirtNumber": "1"
            },
            {
                "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.LineupInfoDto, Betgenius.Sports.Football.Contracts.MatchEvents",
                "id": "1256504",
                "name": "Marulanda, J",
                "firstName": "Jonathan",
                "lastName": "Marulanda",
                "playerStatus": "Starter",
                "position": "Defender",
                "shirtNumber": "4"
            },
            ...
        ]
    },
        "formation": null,
}

Element

Type

Description

formation

string

Team formation

lineup

Lineup array

Lineup collection for the game

id

string

Lineup unique player identifier

name

string

Lineup player’s full name

firstName

string

Lineup player’s first name

lastName

string

Lineup player’s last name

playerStatus

string($x-extensible-enum)

[ Unknown, Starter, Bench, Injured, Suspended, Unavailable ]

Lineup player’s game status

position

string($x-extensible-enum)

[ Unknown, GoalKeeper, Defender, Midfielder, Forward ]

Lineup player’s position

shirtNumber

string

Lineup player’s shirt number

MatchStatusChanged

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.MatchStatusChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "matchStatus": "InProgress",   
}

Element

Type

Description

matchStatus

string($x-extensible-enum)

[Unknown, NotStarted, Warmup, InProgress, Postponed, Finished, Interrupted, CoverageStopped, CoverageResumed, Abandoned, Cancelled, Delayed ]

Indicates the state of the game

Offside

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.OffsideDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Offside.

PenaltyAwarded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyAwardedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty as awarded.

PenaltyMissed

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyMissedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty is missed.

PenaltyRetake

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRetakeDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Penalty is/will be retaken.

PenaltyRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Risk of a penalty.

PenaltyRiskEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PenaltyRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Risk of a penalty is over.

PeriodChanged

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.PeriodChangedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties.

RedCardRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.RedCardRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Risk of a red card.

RedCardRiskEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.RedCardRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Risk of a red card is over.

ShirtColorMajor

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShirtColorMajorDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "Color": "skyblue"
}

Element

Type

Description

Color

string

Major shirt color

ShirtColorMinor

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShirtColorMinorDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "Color": "skyblue"
}

Element

Type

Description

color

string

Minor shirt color

Shot

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ShotDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "onTarget": null,
    "hitWoodwork": null,
    "blocked": null, 
}

Element

Type

Description

onTarget

boolean

Indicates the shot is on target.

hitWoodwork

boolean

Indicates the shot hit the woodwork

blocked

boolean

Indicates the shot is blocked

StoppageTime

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.StoppageTimeDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "announcedMinutes": 5,
}

Element

Type

Description

announcedMinutes

integer

Game’s stoppage time

Substitution

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.SubstitutionDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "out": {
        "id": null,
        "name": null
    },
    "in": {
        "id": null,
        "name": null
    }
}

Element

Type

Description

out

{}

Player being subbed out

in

{}

Player being subbed in

id

string

Unique player identifier

name

string

Player’s name

ThrowIn

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.ThrowInDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "state": "Unknown"
}

Element

Type

Description

state

string($x-extensible-enum)

[ Unknown, Safe, Attack, DangerousAttack ]

Danger state data

Var

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "varReason": "Penalty"
}

Element

Type

Description

varReason

string($x-extensible-enum)

[ NotSet, HomeGoal, HomePenalty, HomeRedCard, HomeMistakenIdentity, AwayGoal, AwayPenalty, AwayRedCard, AwayMistakenIdentity, Goal, Penalty, RedCard, MistakenIdentity, HomeUnknown, AwayUnknown, Unknown, PenaltyRetake, HomePenaltyRetake, AwayPenaltyRetake ]

Reason for initiation of VAR

VarEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "varOutcome": "AwayPenaltyAwarded"
}

Element

Type

Description

varOutcome

string($x-extensible-enum)

[ NotSet, HomeNoGoal, AwayNoGoal, NoGoal, HomeGoalAwarded, AwayGoalAwarded, GoalAwarded, HomeNoPenalty, AwayNoPenalty, NoPenalty, HomePenaltyAwarded, AwayPenaltyAwarded, PenaltyAwarded, HomeNoRedCard, AwayNoRedCard, NoRedCard, HomeRedCardGiven, AwayRedCardGiven, RedCardGiven, HomePlayerNotChanged, AwayPlayerNotChanged, PlayerNotChanged, HomePlayerChanged, AwayPlayerChanged, PlayerChanged, HomeNoAction, AwayNoAction, NoAction, HomeUnknown, AwayUnknown, Unknown, HomePenaltyWillBeRetaken, AwayPenaltyWillBeRetaken, HomeNoPenaltyRetake, AwayNoPenaltyRetake, PenaltyWillBeRetaken, NoPenaltyRetake ]

Outcome of the initiated VAR

VarRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "varReason": "HomeGoal"
}

Element

Type

Description

varReason

string($x-extensible-enum)

[ NotSet, HomeGoal, HomePenalty, HomeRedCard, HomeMistakenIdentity, AwayGoal, AwayPenalty, AwayRedCard, AwayMistakenIdentity, Goal, Penalty, RedCard, MistakenIdentity, HomeUnknown, AwayUnknown, Unknown, PenaltyRetake, HomePenaltyRetake, AwayPenaltyRetake ]

Potential reason for initiation of VAR

VarRiskEnded

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.VarRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Indicated the VAR risk is over.

YellowCardRisk

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.YellowCardRiskDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Indicates there is a risk of yellow card.

YellowCardRiskEnded

Code Block
{
    "Betgenius.Sports.Football.Contracts.MatchEvents.YellowCardRiskEndedDto, Betgenius.Sports.Football.Contracts.MatchEvents"
}

No specific properties. Indicates the risk of yellow card is over.

Statistics *

Code Block
{
    "$type": "Betgenius.Sports.Football.Contracts.MatchEvents.StatisticsDto, Betgenius.Sports.Football.Contracts.MatchEvents",
    "possession": {
        "home": 61,
        "away": 39
    },
    utcTimestamp: "2022-06-19T23:29:04Z"
}

Element

Type

Description

possession

{}

Possession data field

home

integer

Home team possession in percentages

away

integer

Away team possession in percentages

utcTimestamp

string($date-time)

Timestamp of the message

*This action contains utcTimestamp property but does not contain team, period and gameTime.

Other Match Events

Reliability

Code Block
{
	"$type": "Betgenius.Sports.Contracts.Common.MatchEvents.Reliability, Betgenius.Sports.Contracts.Common.MatchEvents",
	"isReliable": false,
    "reason": "Unreliable score"		
}

Element

Type

Description

isReliable

boolean

Indicates whether the feed data is considered reliable

reason

string

Reason of reliable/unreliable feed state