GetEvents - Saba-sports/OddsDirectAPI GitHub Wiki

This API is to get event information and including some market information.

Request

GET  /sports/{version}/GetEvents?query=$filter=sporttype eq 1&includeMarkets=$filter=bettype eq 128&language=cs
Accept: application/json
Accept-Encoding: br, gzip, deflate
X-Forwarded-For: client ip (If using API via proxy)
Authorization: Bearer {JWT token}
Parameter Description
query Specific the query parameters for using odata query format.
default return top 50, use $skip command when should need other data,please refer to Odata-Query
from Specific the start date of the data. It can be inputted separately.
The date time string format should be like: "2021-01-01T00:00:00", encodable
until Specific the end date of the data. It can be inputted separately.
The date time string format should be like: "2021-01-01T00:00:00", encodable
language Specific the language of the response context
includeMarkets Specify whether it is necessary to return the market information.
If the parameter of includeMarkets does not include in the query parameters, market information will be responded by default.
includeMarkets = $filter=bettype eq 128; Market information is returned with conditions specified (eq, in) by parameters.
includeMarkets = none; Market information is not returned.

Response

{    
    "events": Event[],
    "markets": Market[] | null 
} 
Name Format Description
events Event array Specifies the information of events.
markets Market array Specifies the information of markets.

Event

{
	"sportType": int,
	"sportName": string,
	"leagueId": int,
	"leagueName": string,
        "leagueIconUrl": string,
	"eventId": int,
	"eventCode": string,
	"eventStatus": string,
	"isMainMarket": bool,
	"kickOffTime": DateTime,
	"globalShowTime": DateTime,
	"countryCode": string,
	"gameSession": int,
	"parentId": int,
	"isTest": bool,
	"isLive": bool,
	"isParlay": bool,
	"isCashout": bool,	
	"isVirtualEvent": bool,
	"hasLiveMarket": bool,
	"marketCount": int,
	"marketCategories": int[],
	"streamingOption": int,
	"channelCode": string,
	"teamInfo": TeamInfo,
	"gameInfo": GameInfo,
	"soccerInfo": SoccerInfo | null,
	"tennisInfo": TennisInfo | null,
	"beachVolleyBallInfo": BeachVolleyBallInfo | null,
	"eSportInfo": ESportInfo | null,
        "basketballInfo": BasketballInfo | null,
        "baseballInfo": BaseballInfo | null,
        "volleyballInfo": VolleyballInfo | null,
        "footballInfo": FootballInfo | null,
        "tableTennisInfo": TableTennisInfo | null,
        "badmintonInfo": BadmintonInfo | null,
        "kabaddiInfo": KabaddiInfo | null,
        "leagueGroupingSort": string | null,
        "leagueGroupingName": string | null,
        "leagueGroupingId": string | null
}
Name Format Description Queryable Query Example
sportType int Specifies the identifier of the sport. Yes $filter=sporttype eq 1
sportName string Specifies the name of the sport. Yes $filter=sportname eq 'Soccer'
leagueId int Specifies the identifier of the league. Yes $filter=leagueid eq 56038
leagueName string Specifies the name of the league. Yes $filter=leaguename eq '*UEFA CHAMPIONS LEAGUE' or $filter=contains(leaguename,'NBA')
leagueIconUrl string Specifies the URL of the league image.
If the image not found, please change to use default url.
{domain}/LeagueImg/league_flag.png
Please replace domain with the domain returned by leagueIconUrl
No -
eventId int Specifies the identifier of the event. Yes $filter=eventid eq 38255274
eventCode string Specifies the order of the event. No β€”
eventStatus string Specifies the status of the event.
running/closed/postponed/deleted
Yse $filter=eventStatus eq 'running'
isMainMarket bool Specifies the event is in the main market. Yes $filter=ismainmarket eq true
kickOffTime DateTime Specifies the start time for the event of system. (time zone GMT+0) No β€”
globalShowTime DateTime Specifies the start time for the event. (time zone GMT+0) No β€”
countryCode string Specifies the identifier of the country. No β€”
gameSession int Specifies the total games of the event. No β€”
parentId int Specifies the identifier of the parent event. No β€”
isTest bool Specifies whether the event is test. No β€”
isLive bool Specifies whether the event is live. Yes $filter=islive eq true
isParlay bool Specifies whether the event is parlay. Yes $filter=isparlay eq true
isCashout bool Specifies whether the event supports cashout. Yes $filter=iscashout eq true
isVirtualEvent bool Specifies whether the event is a virtual game. Yes $filter=isvirtualevent eq true
hasLiveMarket bool Specifies the event has a live market. No β€”
marketCount int Specifies the amount of markets for each event. No β€”
marketCategories int[] Specifies the categories of all markets for each event.
0: None
1: FullTime
2: Half
3: Corners /Bookings
4: Intervals
5: Specials
6: Players
7: FastMarket
8: Quarter
9: ExtraTime
10: Penalty
11-19: E-Sports Map 1-9
No β€”
streamingOption int Specifies the identifier of the streaming. Yes $filter=streamingOption eq 131072
channelCode string Specifies the code of the streaming. Yes $filter=channelCode ne null
teamInfo TeamInfo Specifies the information of the team. No β€”
gameInfo GameInfo Specifies the information of the game. No β€”
soccerInfo SoccerInfo Specifies the information of the soccer. No β€”
tennisInfo TennisInfo Specifies the information of the tennis. No β€”
beachVolleyBallInfo BeachVolleyBallInfo Specifies the information of the beach volleyball. No β€”
eSportInfo ESportInfo Specifies the information of the E-Sport. No β€”
basketballInfo BasketballInfo Specifies the information of the Basketball. No β€”
baseballInfo BaseballInfo Specifies the information of the Baseball. No β€”
volleyballInfo VolleyballInfo Specifies the information of the Volleyball. No β€”
footballInfo FootballInfo Specifies the information of the Football. No β€”
tableTennisInfo TableTennisInfo Specifies the information of the TableTennisInfo. No β€”
badmintonInfo BadmintonInfo Specifies the information of the BadmintonInfo. No β€”
kabaddiInfo KabaddiInfo Specifies the information of the KabaddiInfo. No β€”
leagueGroupingSort string Specifies the sort of the league grouping. No -
leagueGroupingName string Specifies the name of the league grouping. No -
leagueGroupingId string Specifies the id of the league grouping. No -

TeamInfo

{
	"homeId": int,
	"homeName": string,
	"homeIconUrl": string,
	"awayId": int,
	"awayName": string,
	"awayIconUrl": string,
}
Name Format Description Queryable Query Example
homeId int Specifies the identifier of the home team. Yes $filter=homeId eq 17892
homeName string Specifies the name of the home team. Yes $filter=contains(homename,'Field')
homeIconUrl string Specifies the URL of the home team image.
If the image not found, please change to use default url.
{domain}/TeamImg/team_flag_home.png
Please replace domain with the domain returned by homeIconUrl
No -
awayId int Specifies the identifier of the away team. Yes $filter=awayid eq 714227
awayName string Specifies the name of the away team. Yes $filter=contains(awayname,'Lakers')
awayIconUrl string Specifies the URL of the away team image.
If the image not found, please change to use default url.
{domain}/TeamImg/team_flag_away.png
Please replace domain with the domain returned by awayIconUrl
No -

GameInfo

{
	"livePeriod": byte,
	"clockDirection": string,
	"seconds": int,
	"isNeutral": bool,
	"isHt": bool,
	"isBreak": bool,
	"isClosed": bool,
	"inJuryTime": byte,
	"delayLive": bool,
	"gameStatus" byte,
	"inPlayTime": string,
	"liveHomeScore": int,
	"liveAwayScore": int
}
Name Format Description Queryable Query Example
livePeriod byte Specifies the current part of the game.
If the value is 0, the front end should not be displayed the time. It means the game is at a special time.
Only support for:
1: Soccer
2: Backetball
3: Football
4: Icehockey
9: Badminton
24: Handball
26: Rugby
43: E-Sports
No β€”
clockDirection string Specifies the clock direction. Two values are possible:"inc"(counting starts from 0 to end game) and "dec"(counting starts from a specific value and goes down to 0) No β€”
seconds int Specifies the current game time in seconds.
Only support for:
1: Soccer
2: Backetball
3: Football
4: Icehockey
9: Badminton
24: Handball
26: Rugby
43: E-Sports
No β€”
isNeutral bool Specifies the game is neither hold in home nor away site. No β€”
isHt bool Specifies the event is in the half time interval. No β€”
isBreak bool Specifies the game is in break time. No β€”
isClosed bool Specifies the event has been closed No β€”
inJuryTime byte Specifies the injury time of the game. No β€”
delayLive bool Specifies whether the event is delaying. No β€”
gameStatus byte Specifies the status for the game.
1=PRC; 2=PPen; 3=VAR; 4=Penalty; 5=Injury; 6=Sudden Death
No β€”
inPlayTime string Specifies the steps of the event is going. No β€”
liveHomeScore int Specifies the current score of home team. No β€”
liveAwayScore int Specifies the current score of away team. No β€”

SoccerInfo

{
	"homeRedCard":byte,
	"awayRedCard":byte,
	"homeYellowCard":byte,
	"awayYellowCard":byte
}
Name Format Description Queryable Query Example
homeRedCard byte Specifies the number of red cards of Home’s. No β€”
awayRedCard byte Specifies the number of red cards of Away’s. No β€”
homeYellowCard byte Specifies the number of yellow cards of Home’s. No β€”
awayYellowCard byte Specifies the number of yellow cards of Away’s. No β€”

TennisInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"homePointScore": string,
	"awayPointScore": string,
	"currentSet": int,
	"currentServe": int
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
awayGameScore int[] Specifies the number of the point in a set, the Away player got. No β€”
homePointScore string Specifies the Home’s point of current game. No β€”
awayPointScore string Specifies the Away’s point of current game. No β€”
currentSet int Specifies the current set. No β€”
currentServe int Specifies which team is current server.
0=No Current Serve, 1=home, 2=away
No β€”

BeachVolleyBallInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"currentSet": int,
	"currentServe": int,
	"playerInjury": int,
	"isRain" bool
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
awayGameScore int[] Specifies the number of the point in a set, the Away player got. No β€”
currentSet int Specifies the current set. No β€”
currentServe int Specifies which team is current server.
0=No Current Serve, 1=home, 2=away
No β€”
playerInjury int Specifies which team is injury.
0=no one, 1=home, 2=away, 3=both
No β€”
isRain bool Specifies whether the weather is raining. No β€”

ESportInfo

{
	"bestOfMap": int,
	"isStartingSoon": bool,
	"moveBO3Down": bool,
	"overTimeSession": int,
	"leagueGroup": string,
	"leagueGroupId": int
}
Name Format Description Queryable Query Example
bestOfMap int Specifies how many maps will be use. No β€”
isStartingSoon bool Specifies the competition is starting soon. No β€”
moveBO3Down bool Specifies to display a flag in web page. No β€”
overTimeSession int

Specifies the information of games.
1 β†’ Dota2 ; 2 β†’ LOL ; 3 β†’ CS2 ; 4 β†’ KOG ; 5 β†’ LOL:Wild Rift ; 6 β†’ Valorant ; 7 β†’ Arena of Valor ; 8 β†’ PUBG ; 9 β†’ Mobile Legends ; 10 β†’ Overwatch ; 11 β†’ Rainbow Six ; 12 β†’ StarCraft 2 ; 13 β†’ Warcraft 3 ; 14 β†’ CrossFire ; 15 β†’ Crossfire Mobile ; 16 β†’ Call of Duty ; 17 β†’ PUBG Mobile ; 18 β†’ Apex Legends ; 19 β†’ Rocket League ; 20 β†’ Age of Empires ; 21 β†’ Call of Duty: Mobile ; 22 β†’ BrawlStars ; 23 β†’ Freefire ; 24 β†’ E-Sports Virtual ; 25 β†’ Others

Yes $filter=overTimeSession eq 1
leagueGroup string Specifies the name of the league group. No β€”
leagueGroupId int Specifies the identifier of the league group. Yes $filter=leagueGroupId eq 208
please refer to E-Sports Group

BasketballInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"latestLivePeriod":int,
	"homeOverTimeScore": int,
	"awayOverTimeScore": int
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the current score of home team. No β€”
awayGameScore int[] Specifies the current score of away team. No β€”
latestLivePeriod int Specifies current period No β€”
homeOverTimeScore int Specifies the current overtime score of home team. No β€”
awayOverTimeScore int Specifies the current overtime score of away team. No β€”

BaseballInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"homeOverTimeScore": int,
	"awayOverTimeScore": int,
	"baseHasRunner": bool[],
        "currentInning": int,
        "currentBattingTeam": int,
        "currentOuts": int
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the current score of home team. No β€”
awayGameScore int[] Specifies the current score of away team. No β€”
homeOverTimeScore int Specifies the current overtime score of home team. No β€”
awayOverTimeScore int Specifies the current overtime score of away team. No β€”
baseHasRunner bool[] Specifies which base has runner.
First Item Indicates True If There's a Runner on First Base And So On
No β€”
currentInning int Specifies current inning number No β€”
currentBattingTeam int Specifies Current Batting Team
1=Home,2=Away
No β€”
currentOuts int Specifies current outs in batting team No β€”

VolleyballInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"homePointScore":int,
	"awayPointScore":int,
	"currentServe":int, 
	"homeCurrentPoint":int,
	"awayCurrentPoint":int,
	"playerInjury":int,
        "latestLivePeriod":int
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
awayGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
homePointScore int Specifies Home Team Total Score No β€”
awayPointScore int Specifies Away Team Total Score No β€”
currentServe int Specifies which team is current server.
0=No Current Serve, 1=home, 2=away
No β€”
homeCurrentPoint int Specifies home team score in current period No β€”
awayCurrentPoint int Specifies away team score in current period No β€”
playerInjury int Specifies which team is injury.
0=no one, 1=home, 2=away, 3=both
No β€”
latestLivePeriod int Specifies current period No β€”

FootballInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"homeCurrentPoint":int,
	"awayCurrentPoint":int,
	"homeOverTimeScore":int, 
	"awayOverTimeScore":int
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
awayGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
homeCurrentPoint int Specifies home team score in current period No β€”
awayCurrentPoint int Specifies away team score in current period No β€”
homeOverTimeScore int Specifies home team score in overtime period No β€”
awayOverTimeScore int Specifies away team score in overtime period No β€”

TableTennisInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
        "homeCurrentPoint":int,
	"awayCurrentPoint":int,
	"homeSetScore":int,
	"awaySetScore":int,
        "isRain":bool,
        "playerInjury":int,
        "CurrentSet":int,
	"currentServe":int 
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
awayGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
homeCurrentPoint int Specifies home team score in current period No β€”
awayCurrentPoint int Specifies away team score in current period No β€”
homeSetScore int Specifies how many sets does home team get. No β€”
awaySetScore int Specifies how many sets does away team get. No β€”
isRain bool Specifies whether the weather is raining. No β€”
playerInjury int Specifies which team is injury.
0=no one, 1=home, 2=away, 3=both
No β€”
CurrentSet int Specifies the current set. No β€”
currentServe int Specifies which team is current server.
0=No Current Serve, 1=home, 2=away
No β€”

BadmintonInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
        "homeCurrentPoint":int,
	"awayCurrentPoint":int,
	"homeSetScore":int,
	"awaySetScore":int,
        "playerInjury":int,
        "CurrentSet":int,
	"currentServe":int 
}
Name Format Description Queryable Query Example
homeGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
awayGameScore int[] Specifies the number of the point in a set, the Home player got. No β€”
homeCurrentPoint int Specifies home team score in current period No β€”
awayCurrentPoint int Specifies away team score in current period No β€”
homeSetScore int Specifies how many sets does home team get. No β€”
awaySetScore int Specifies how many sets does away team get. No β€”
playerInjury int Specifies which team is injury.
0=no one, 1=home, 2=away, 3=both
No β€”
CurrentSet int Specifies the current set. No β€”
currentServe int Specifies which team is current server.
0=No Current Serve, 1=home, 2=away
No β€”

KabaddiInfo

{
	"homePoint": int,
	"awayPoint": int,
	"homeFirstHalfPoint": int,
	"homeSecondHalfPoint": int,
	"homeFirstHalfOverTimePoint": int,
	"homeSecondHalfOverTimePoint": int,
	"homeGoldenRaidPoint": int,
	"awayFirstHalfPoint": int,
	"awaySecondHalfPoint": int,
	"awayFirstHalfOverTimePoint": int,
	"awaySecondHalfOverTimePoint": int,
	"awayGoldenRaidPoint": int,
	"turn": int,
	"interrupted": int,
	"latestLivePeriod": int,
	"hideLiveScore": int
}
Name Format Description Queryable Query Example
homePoint int Specifies home team points in current period. No β€”
awayPoint int Specifies away team points in current period. No β€”
homeFirstHalfPoint int Specifies the first half points of home team. No β€”
homeSecondHalfPoint int Specifies the second half points of home team. No β€”
homeFirstHalfOverTimePoint int Specifies the first half overtime points of home team. No β€”
homeSecondHalfOverTimePoint int Specifies the second half overtime points of home team. No β€”
homeGoldenRaidPoint int Specifies the golden raid points of home team. No β€”
awayFirstHalfPoint int Specifies the first half points of away team. No β€”
awaySecondHalfPoint int Specifies the second half points of away team. No β€”
awayFirstHalfOverTimePoint int Specifies the first half overtime points of away team. No β€”
awaySecondHalfOverTimePoint int Specifies the second half overtime points of away team. No β€”
awayGoldenRaidPoint int Specifies the golden raid points of away team. No β€”
turn int Turn.
0=default, 1=home, 2=away
No β€”
interrupted int Interrupted No β€”
latestLivePeriod int Specifies current period. No β€”
hideLiveScore int Hide live score.
0=show, 1=hide
No β€”

Market

please reference GetMarkets response

⚠️ **GitHub.com Fallback** ⚠️