beta GetEvents - Saba-sports/OddsDirectAPI_CN GitHub Wiki

此API用于获取赛事相关信息包含部分盘口信息

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 (如果通过代理使用API需要额外带入)
Authorization: Bearer {JWT token}
Parameter Description
query 使用Odata指定特定格式的查询
from 指定赛事开始日期,可以单独输入
until 指定赛事结束日期,可以单独输入
language 指定欲回应的数据语系,请参阅Language Table
includeMarkets 此参数仅在 /GetEvents 中使用,指定是否有必要回传market讯息。
如果includeMarkets未指定,则默认回传。
includeMarkets = $filter=bettype eq 128; 仅筛选指定条件Market信息。
includeMarkets = none; 将不回传Market信息。

Response

{    
    "events": Event[],
    "markets": Market[] | null 
} 
Name Format Description
events Event array 赛事信息列表
markets Market array 盘口信息列表

Event

{
	"sportType": int,
	"sportName": string,
	"leagueId": int,
	"leagueName": 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,
}
Name Format Description Queryable Query Example
sportType int 体育项目ID Yes $filter=sporttype eq 1
sportName string 体育项目名称 Yes $filter=sportname eq 'Soccer'
leagueId int 联赛ID Yes $filter=leagueid eq 56038
leagueName string 联赛名称 Yes $filter=leaguename eq '*UEFA CHAMPIONS LEAGUE' or $filter=contains(leaguename,'NBA')
eventId int 赛事ID Yes $filter=eventid eq 38255274
eventCode string 赛事代码 No —
eventStatus string 赛事状态
running/ closed/ postponed/ deleted
Yes $filter=eventStatus eq 'running'
isMainMarket bool 是否为主要盘口 Yes $filter=ismainmarket eq true
kickOffTime DateTime 系统开赛时间 (时区GMT+0) No —
globalShowTime DateTime 开赛时间 (时区GMT+0) No —
countryCode string 联赛国别代码 No —
gameSession int 赛事比赛有多少节 No —
parentId int 该赛事的母赛事ID No —
isTest bool 是否为测试赛事 No —
isLive bool 是否为滚球赛事 Yes $filter=islive eq true
isParlay bool 是否为串关赛事 Yes $filter=isparlay eq true
isCashout bool 赛事是否支持实时兑现 Yes $filter=iscashout eq true
isVirtualEvent bool 是否为虚拟赛事 Yes $filter=isvirtualevent eq true
hasLiveMarket bool 是否有滚球盘口 No —
marketCount int 该赛事的所有盘口数量 No —
marketCategories int[] 该赛事的所有盘口投注类型
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 (电子竞技适用 – 地图 1~9)
No —
streamingOption int 视频ID Yes $filter=streamingOption eq 131072
channelCode string 视频代码 Yes $filter=channelCode ne null
teamInfo TeamInfo 团队相关信息 No —
gameInfo GameInfo 球赛相关信息 No —
soccerInfo SoccerInfo 足球相关信息 No —
tennisInfo TennisInfo 网球相关信息 No —
beachVolleyBallInfo BeachVolleyBallInfo 沙滩排球相关信息 No —
eSportInfo ESportInfo 电子竞技相关信息 No —

TeamInfo

{
	"homeId": int,
	"homeName": string,
	"homeIconUrl": string
	"awayId": int,
	"awayName": string,
	"awayIconUrl": string
}
Name Format Description Queryable Query Example
homeId int 主队ID Yes $filter=homeId eq 17892
homeName string 主队名称 Yes $filter=contains(homename,'Field')
homeIconUrl string 主队队徽URL, 如果图片不存在请使用预设主队队徽URL
{domain}/TeamImg/team_flag_home.png
No -
awayId int 客队ID Yes $filter=awayid eq 714227
awayName string 客队名称 Yes $filter=contains(awayname,'Lakers')
awayIconUrl string 客队队徽URL, 如果图片不存在请使用预设客队队徽URL
{domain}/TeamImg/team_flag_away.png
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 目前进行到第几节
如果值为 0,则前端不显示时间。这意味着比赛正处于特殊时期。
No —
clockDirection string 赛事时间计算方式
inc:从0开始计数到赛事结束
dec:从特定值开始计数到0
No —
seconds int 当前赛事时间以秒为单位 No —
isNeutral bool 是否为中立场 No —
isHt bool 是否为中场休息 No —
isBreak bool 赛事是否中断(休息时间) No —
isClosed bool 赛事是否关闭 No —
inJuryTime byte 伤停时间 No —
delayLive bool 赛事是否延迟 No —
gameStatus byte 球赛状态
1=PRC(有可能被判红牌)
2=PPen(有可能被判点球)
3=VAR(视频助理裁判)
4=Penalty(点球)
5=Injury(球员受伤)
6=Sudden Death(骤死赛)
No —
inPlayTime string 目前赛事时间 No —
liveHomeScore int 主队滚球分数 No —
liveAwayScore int 客队滚球分数 No —

SoccerInfo

{
	"homeRedCard":byte,
	"awayRedCard":byte,
	"homeYellowCard":byte,
	"awayYellowCard":byte
}
Name Format Description Queryable Query Example
homeRedCard byte 主场红牌数 No —
awayRedCard byte 客场红牌数 No —
homeYellowCard byte 主场黄牌数 No —
awayYellowCard byte 客场黄牌数 No —

TennisInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"homePointScore": string,
	"awayPointScore": string,
	"currentSet": int,
	"currentServe": int
}
Name Format Description Queryable Query Example
homeGameScore int[] 主队每盘获得局数 No —
awayGameScore int[] 客队每盘获得局数 No —
homePointScore string 主队目前局数比分 No —
awayPointScore string 客队目前局数比分 No —
currentSet int 目前盘数 No —
currentServe int 目前发球方 No —

BeachVolleyBallInfo

{
	"homeGameScore": int[],
	"awayGameScore": int[],
	"currentSet": int,
	"currentServe": int,
	"playerInjury": int,
	"isRain" bool`
}
Name Format Description Queryable Query Example
homeGameScore int[] 主队每盘获得局数 No —
awayGameScore int[] 客队每盘获得局数 No —
currentSet int 目前盘数 No —
currentServe int 目前发球方 No —
playerInjury int 哪支队伍有人受伤
0=no one(无), 1=home(主队), 2=away(客队), 3=both(两队)
No —
isRain bool 是否为雨天 No —

ESportInfo

{
	"bestOfMap": int,
	"isStartingSoon": bool,
	"moveBO3Down": bool,
	"overTimeSession": int,
	"leagueGroup": string,
	"leagueGroupId": int
}
Name Format Description Queryable Query Example
bestOfMap int Best Of Map标识会打几个地图 No —
isStartingSoon bool 是否即将开赛 No —
moveBO3Down bool 控制是否显示网页的旗帜 No —
overTimeSession int 联赛信息
1 → Dota2 ; 2 → LOL ; 3 → CS2 ; 4 → KOG ; 99 → Others
No —
leagueGroup string 电子竞技联赛名称 No —
leagueGroupId int 电子竞技联赛ID No —

Market

盘口相关信息请参阅GetMarkets

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