纳米体育数据足球数据接口：高阶数据包接口文档API示例①

纳米体育数据的数据接口通过JSON拉流方式获取200多个国家的体育赛事实时数据或历史数据的编程接口，无请求次数限制，可按需购买，接口稳定高效；覆盖项目包括足球、篮球、网球、电子竞技、奥运等专题、数据内容。

纳米数据API2.0版本包含http协议以及websocket协议，主要通过http获取数据，实时数据通过websocket获取。

http协议支持http和https，每个接口都需要传递用户名和密钥用于验证接口权限，白名单ip才能够获取相关数据。

---

以下为纳米足球数据接口文档中足球——高阶数据包——获取比赛分析数据接口文档展示：

获取比赛分析数据

返回比赛分析统计数据（历史交锋/近期战绩、未来赛程、进球分布）

该接口用于请求未开赛的比赛的历史对阵等数据，多为历史数据，变化不频繁
请求限制：前30天比赛

请求次数：60次/min

请求参数：TREE

• userstring

  用户名，请联系商务

• secretstring

  用户密钥，请联系商务

• idinteger

  比赛id

返回参数：TREE

{

code:

integer

results: {info: {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}history: {

历史交锋/近期战绩

vs:[

历史交锋（格式同 info比赛信息字段）

 {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}]home:[

主队近期战绩（格式同 info比赛信息字段）

 {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}]away:[

客队近期战绩（格式同 info比赛信息字段）

 {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}]}future: {

未来赛程

vs:[

交锋赛程（格式同 info比赛信息字段）

 {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}]home:[

主队近期赛程（格式同 info比赛信息字段）

 {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}]away:[

客队近期赛程（格式同 info比赛信息字段）

 {id: integer

比赛id

season_id: integer

赛季id

competition_id: integer

赛事id

home_team_id: integer

主队id

away_team_id: integer

客队id

status_id: integer

比赛状态，详见状态码->比赛状态

match_time: integer

比赛时间

neutral: integer

是否中立场，1-是、0-否

note: string

备注

home_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]away_scores:[

比分字段说明
example：[1, 0, 0, 0, -1, 0, 0]

Enum:Array[7]

0:"比分(常规时间) - int"

1:"半场比分 - int"

2:"红牌 - int"

3:"黄牌 - int"

4:"角球，-1表示没有角球数据 - int"

5:"加时比分(120分钟，即包括常规时间比分)，加时赛才有 - int"

6:"点球大战比分(不包含常规时间及加时赛比分)，点球大战才有 - int"

]home_position: string

主队排名

away_position: string

客队排名

round: {

关联信息

stage_id: integer

阶段id

group_num: integer

第几组，1-A、2-B以此类推

round_num: integer

第几轮

}odds:[

BET365初盘
example：["0.86,-0.5,1.04,0","3.8,3.6,2.05,0","0.9,2.75,1.0,0","0.9,9,0.9,0"]

Enum:Array[4]

0:"亚盘 主,盘口,客,是否封盘 - string"

1:"欧盘 胜,平,负,是否封盘 - string"

2:"大小盘 大,盘口,小,是否封盘 - string"

3:"角球 大,盘口,小,是否封盘 - string"

]}]}goal_distribution: {

进球分布，可能不存在

home: {

主队进球分布，没有数据为空

all: {

全部场次

matches: integer

比赛场次

scored:[

主队进球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]conceded:[

主队失球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]}home: {

主场场次

matches: integer

比赛场次

scored:[

主队主场进球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]conceded:[

主队主场失球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]}away: {

客场场次

matches: integer

比赛场次

scored:[

主队客场进球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]conceded:[

主队客场失球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]}}away: {

客队进球分布，没有数据为空

all: {

全部场次

matches: integer

比赛场次

scored:[

客队进球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]conceded:[

客队失球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]}home: {

主场场次

matches: integer

比赛场次

scored:[

客队主场进球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]conceded:[

客队主场失球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]}away: {

客场场次

matches: integer

比赛场次

scored:[

客队客场进球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]conceded:[

客队客场失球分布

[

15分钟为一段，共6段
example：[5, 26, 1, 15]

Enum:Array[4]

0:"个数 - int"

1:"百分比（%） - int"

2:"开始时间（分钟数） - int"

3:"结束时间（分钟数） - int"

]]}}}}

}