GetEvents - Saba-sports/OddsDirectAPI GitHub Wiki
This API is to get event information and including some market information.
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. |
{
"events": Event[],
"markets": Market[] | null
}
Name | Format | Description |
---|---|---|
events | Event array | Specifies the information of events. |
markets | Market array | Specifies the information of markets. |
{
"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
}
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 | β |
{
"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 | - |
{
"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 | β |
{
"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 | β |
{
"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 | β |
{
"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 | β |
{
"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. |
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 |
{
"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 | β |
{
"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 | β |
{
"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 | β |
{
"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 | β |
{
"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 | β |
{
"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 | β |
please reference GetMarkets response