SC体育足球数据API

通用调用规范与认证机制

大纲

通用调用规范与认证机制H2

1. 服务基准地址H3

  • 生产环境: https://sportapi.skjpt.com/

2. 鉴权认证方式H3

每个接口均必须携带合法的 token 参数（通过 URL Query 或 POST 表单/JSON 传递）：

  • 参数名: token
  • 说明: 系统颁发的有效访问密钥。若无权限或过期将返回 code: 1。

3. 通用响应结构H3

所有接口统一返回标准 JSON 结构：

JSON
{
  "msg": "success",
  "code": 0,
  "data": ...
}
  • code: 状态码。0 表示成功；1 表示请求失败或发生业务异常。
  • msg: 提示信息（如 "success"、"超频限制"、"没有权限访问该接口，请先购买产品"、"参数格式不对" 等）。
  • data: 接口业务数据主体（数组或对象）。

4. 频控与缓存限制H3

  • 接口底层接入 Redis 高速缓存，对于相同参数的高频请求优先直接命中缓存。
  • 超过单客户端/单 IP 设定的访问频次时将返回：{"msg":"超频限制","code":1,"data":null}。

5. 错误码与常见异常排查指南H3

错误信息 (msg)原因说明解决建议
参数格式不对缺少必要的必填参数（如未传 token、type 或 match_id）参照接口文档检查 Query 或 Body 参数名与类型
没有权限访问该接口，请先购买产品Token 权限列表中未包含该接口的 func_id联系系统管理员为该 Token 配置分配对应接口权限
超频限制单 Token / 单 IP 访问频次突破系统限流阈值降低并发频率，或利用本地缓存机制复用查询结果
比赛不存在传入的 match_id 在系统赛事库中未找到核对 match_id 是否有效，建议先通过 /api/football 查出 ID
比赛未结束调用 /api/football_bet_result 时比赛状态非 -1（尚未完场）仅在比赛结束完场（status = -1）后发起算奖
不支持的盘口计算或无结果传入了非法的 market_key 或 bet_item 字段缺失检查 market_key 拼写及 handicap、header 格式

1. 比赛赛程、比分与赛况检索接口

大纲

1.1 接口概述H3

该接口为足球赛程基础总线，支持按时间跨度（按天、年度、近24小时、全量）、特定比赛 ID、联赛星标热度以及盘口开出情况进行全方位检索。支持多语言球队名/联赛名映射，并可通过参数动态左连接关联详细的赛果比分、技术统计和事件链。

1.2 请求方式H3

  • Method: GET
  • URL: /api/football

1.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-访问授权凭证YOUR_API_TOKEN
datestring否近-12h~+48h1. YYYY-MM-DD（指定某天比赛）
2. YYYY（如 2026 检索全年）
3. active（近24小时内未完场和所有未开赛的比赛）
4. all（不限日期，配合 match_id 使用）		2026-09-14
match_idstring/array否-单个比赛 ID，或多个比赛 ID（英文逗号分割或数组）180710745 或 180710745,180710753
leaguestring否-联赛英文名称过滤。特别地，传 hot 自动筛选数据库中带 ⭐ 星标的热门顶级联赛Premier League 或 hot
countrystring否-按国家代码过滤gb
oddsstring/int否-传 1 时，响应中嵌入Bet365核心玩法赛前赔率，传 only 时，强制只返回已开出 Bet365 核心盘口（让球/独赢/大小球）的比赛1
statsint否0传 1 时，响应中嵌入赛况详细统计（角球、黄红牌、控球率、射门等）1
eventsint否0传 1 时，响应中嵌入比赛事件链（进球、换人、红黄牌发生分钟及球员）1
extraint否0传 1 时，响应中嵌入附加扩展信息（裁判、球场、加时赛等）1
langstring否-球队多语言格式，多语言用 % 分割，支持 cn、tc、jacn%tc
statusint否-比赛状态过滤（如 -1 为完场）-1
page_numint否1分页页码（从 1 开始）1
page_sizeint否1000分页每页记录数（最大 1000）20
descint否0时间排序方向：0 为升序 ASC，1 为降序 DESC1
league_listint否0传 1 时，同时统计并返回当前检索结果中的联赛聚合信息及数量1

1.4 比赛状态码（status）说明H3

  • 0: 未开赛
  • 1: 上半场进行中
  • 2: 半场休息
  • 3: 下半场进行中
  • 4: 加时赛
  • 5: 点球决战
  • -1: 完场结束
  • -10: 取消
  • -11: 待定
  • -12: 腰斩 / 暂停
  • -13: 延期
  • -14: 比赛中断

1.5 响应数据示例H3

JSON
{
    "msg": "success",
    "code": 0,
    "data": [
        {
            "match_id": "11255767",
            "bet365_id": 200161991,
            "league_name": "智利甲级联赛",
            "league_en": "Chile Liga de Primera",
            "match_time": "2026-09-14 04:30:00",
            "home_name": "科洛科洛",
            "home_en": "Colo Colo",
            "away_name": "康塞普西翁|体育",
            "away_en": "Deportes Concepcion",
            "status": "-1",
            "home_score": "1",
            "away_score": "1",
            "home_half_score": "0",
            "away_half_score": "1",
            "home_image_id": "1748605142700",
            "away_image_id": "1746096419115",
            "league_image_id": "1728528061912",
            "league_country": "cl",
            "hot": 0,
            "home_country": "cl",
            "away_country": "cl",
            "ls": "1-1"
        }
    ]
}

1.6 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "date=2026-09-14" \
  --data-urlencode "stats=1" \
  --data-urlencode "page_size=2"

2. 反波胆/正波胆赔率接口

大纲

2.1 接口概述H3

反波胆（Lay Score Odds）核心接口，从底层赔率库中提取全场比分项、半场比分项以及进球时间段赔率，并自动根据系统配置的赔率系数（odds ratio）折算。支持正波胆转换模式（is_betting=1）。

2.2 请求方式H3

  • Method: GET
  • URL: /api/football_odds

2.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
typeint是-玩法类型：
1: 全场比分（18项/40项带 over4 大比分）
2: 半场比分
3: 时间段第一个进球		1
datestring否近-12h~+48h比赛日期 YYYY-MM-DD2026-09-14
is_bettingint否0传 1 时，输出正波胆赔率1
page_numint否1页码1
page_sizeint否1000每页记录数10

2.4 响应数据示例H3

JSON
{
  "msg": "success",
  "code": 0,
  "data": [
    {
      "match_id": "13053515",
      "modify_time": "2026-09-14 04:14:46",
      "odds": {
        "betting_odds_items": [
          { "home_score": "1", "away_score": "0", "ratio": 8.79 },
          { "home_score": "2", "away_score": "0", "ratio": 8.12 },
          { "home_score": "2", "away_score": "1", "ratio": 6.21 },
          { "home_score": "0", "away_score": "0", "ratio": 5.27 },
          { "home_score": "1", "away_score": "1", "ratio": 6.6 },
          { "home_score": "0", "away_score": "1", "ratio": 3.52 }
        ],
        "over4": [
          { "name": "4-0", "ratio": 2.77 },
          { "name": "4-1", "ratio": 2.3 }
        ]
      }
    }
  ]
}

2.5 字段说明H3

  • ratio: 净收益率/赔率（反波胆为百分比/正波胆为倍数赔率）。
  • home_score / away_score: 对应的主客队预测比分（反波胆意为非该比分即中奖）。
  • over4: 当全场进球数超过 4 球时的大比分特殊项归集。

2.6 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjptcom/api/football_odds" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "type=1" \
  --data-urlencode "date=2026-09-14" \
  --data-urlencode "page_size=1"

3. 多机构赛前全玩法赔率接口

大纲

3.1 接口概述H3

用于拉取指定比赛的全量玩法赛前盘口与历史变盘快照。涵盖主流博彩公司（默认 Bet365，支持 Pinnacle、Betfair、188Bet 等）。数据自动按玩法大类（主要盘口 main、亚洲让分 asian_lines、进球大小 goals、半场盘口 half、角球 corners 等）进行结构化归集。

3.2 请求方式H3

  • Method: GET
  • URL: /api/football_odds_more

3.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
match_idstring是-比赛 ID180710745
bookmakerstring否Bet365指定机构名称，传 all 时返回所有博彩机构聚类数据Bet365 或 all

3.4 响应数据示例（指定 Bet365）H3

JSON
{
    "msg": "success",
    "code": 0,
    "data": {
        "main": {
            "name": "Main",
            "asian_handicap": {
                "name": "Asian Handicap",
                "odds": [
                    [
                        {
                            "id": 1789193115,
                            "odds": "1.875",
                            "header": "1",
                            "handicap": "0.0,+0.5"
                        },
                        {
                            "id": 1789193115,
                            "odds": "1.925",
                            "header": "2",
                            "handicap": "0.0,-0.5"
                        }
                    ],
                    [
                        {
                            "id": 1789388872,
                            "odds": "1.825",
                            "header": "1",
                            "handicap": "0.0"
                        },
                        {
                            "id": 1789388872,
                            "odds": "1.975",
                            "header": "2",
                            "handicap": "0.0"
                        }
                    ],
                    [
                        {
                            "id": 1789391121,
                            "odds": "1.850",
                            "header": "1",
                            "handicap": "0.0"
                        },
                        {
                            "id": 1789391121,
                            "odds": "1.950",
                            "header": "2",
                            "handicap": "0.0"
                        }
                    ]
                ]
            },
            "full_time_result": {
                "name": "Full Time Result",
                "odds": [
                    [
                        {
                            "id": 1789191430,
                            "odds": "3.100",
                            "name": "1"
                        },
                        {
                            "id": 1789191430,
                            "odds": "3.200",
                            "name": "Draw"
                        },
                        {
                            "id": 1789191430,
                            "odds": "2.200",
                            "name": "2"
                        }
                    ],
                    [
                        {
                            "id": 1789389685,
                            "odds": "2.550",
                            "name": "1"
                        },
                        {
                            "id": 1789389685,
                            "odds": "3.100",
                            "name": "Draw"
                        },
                        {
                            "id": 1789389685,
                            "odds": "2.750",
                            "name": "2"
                        }
                    ]
                ]
            },
            "goal_line": {
                "name": "Goal Line",
                "odds": [
                    [
                        {
                            "id": 1789193115,
                            "odds": "2.025",
                            "header": "Over",
                            "name": "2.0,2.5"
                        },
                        {
                            "id": 1789193115,
                            "odds": "1.775",
                            "header": "Under",
                            "name": "2.0,2.5"
                        }
                    ],
                    [
                        {
                            "id": 1789373069,
                            "odds": "1.800",
                            "header": "Over",
                            "name": "2.0"
                        },
                        {
                            "id": 1789373069,
                            "odds": "2.000",
                            "header": "Under",
                            "name": "2.0"
                        }
                    ]
                ]
            }
        }
    }
}

3.5 返回说明H3

  • 核心玩法都是返回包含多组赔率历史记录的数据,最后一组赔率为最新的赔率,id为时间戳。

3.6 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football_odds_more" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "match_id=11255767" \
  --data-urlencode "bookmaker=Bet365"

4. 赛果详情、技术统计与事件流接口

大纲

4.1 接口概述H3

完赛与即时赛况的深度技术统计接口。返回比分切片（全场比分、半场比分、加时比分）、全量维度技术统计（控球率、射门、射正、危险进攻、犯规、角球、黄红牌等）以及精准到分钟级的现场事件时序链（进球、点球、乌龙、黄牌、红牌、换人）。

4.2 请求方式H3

  • Method: GET
  • URL: /api/football_result

4.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
match_idstring是-比赛 ID180710745

4.4 响应数据示例H3

JSON
{
  "msg": "success",
  "code": 0,
  "data": {
    "scores": {
      "1": { "home": "0", "away": "1" },
      "2": { "home": "1", "away": "1" },
      "rs": "1-1"
    },
    "stats": {
      "attacks": [ "112", "86" ],
      "dangerous_attacks": [ "64", "41" ],
      "shots_on_target": [ "7", "3" ],
      "shots_off_target": [ "9", "4" ],
      "corners": [ "8", "2" ],
      "fouls": [ "11", "15" ],
      "yellowcards": [ "2", "3" ],
      "redcards": [ "0", "0" ]
    },
    "events": [
      {
        "id": "1001",
        "text": "14' - 1st Goal - (Deportes Concepcion)",
        "time": "14",
        "type": "goal",
        "team": "away"
      },
      {
        "id": "1002",
        "text": "68' - 2nd Goal - (Colo Colo)",
        "time": "68",
        "type": "goal",
        "team": "home"
      }
    ],
    "extra": {
      "round": "Round 23",
      "stadium": "Estadio Monumental David Arellano",
      "referee": "P. Maza"
    }
  }
}

4.5 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football_result" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "match_id=11255767"

5. 球队与联赛多语言图谱库接口

大纲

5.1 接口概述H3

球队与联赛的标准知识图谱库。具备自动区分国家分类、联赛分类、球队分类功能。支持中简（team_cn）、中繁（team_tc）、日文（team_ja）及英文（team_en）名称多语言映射，并提供历年参赛记录与官方维基 remark 考证。

5.2 请求方式H3

  • Method: GET
  • URL: /api/football_teams

5.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
namestring否-球队或联赛英文名（支持模糊与精确匹配搜索，完全匹配优先排序）AC Milan
typeint否-分类类型：
1: 球队（Club / Team）
2: 联赛（League / Tournament）		1
dateint否-比赛所属年份，球队参加过的联赛中英文名列表，或联赛里的所有球队中英文名列表（只针对参数name和type有值的情况）1
countrystring否-按国家名过滤。若未传 name 且未传 type，传 country 可列出该国所有联赛gb
调用分支说明：
1. name 为空，且 type 与 country 均为空：返回系统内全部去重后的国家列表。
2. name 为空，country 有值：返回该国家下的联赛列表（type=2）。
3. name 有值：进行英文模糊搜索（完全匹配排首位），限制最多返回 10 条，且 type=1 时会自动解析出球队参加过的历史联赛名及年份（league_en / league_cn）。

5.4 响应数据示例H3

JSON
{
    "msg": "success",
    "code": 0,
    "data": [
        {
            "id": "15602",
            "team_en": "AC Milan",
            "t_en": "",
            "team_cn": "AC米兰",
            "team_tc": "AC米蘭",
            "team_ja": "ACミラン",
            "type": "1",
            "league_en": {
                "Italy Serie A": {
                    "count": 218,
                    "last_match": "2026-09-13 00:00:00"
                },
                "UEFA Champions League": {
                    "count": 34,
                    "last_match": "2025-02-19 01:45:00"
                },
                "Italian Serie A": {
                    "count": 25,
                    "last_match": "2020-12-17 03:45:00"
                },
                "Elite Club Friendlies": {
                    "count": 34,
                    "last_match": "2026-08-08 20:00:00"
                },
                "UEFA Europa League": {
                    "count": 19,
                    "last_match": "2024-04-19 03:00:00"
                },
                "Coppa Italia": {
                    "count": 19,
                    "last_match": "2025-12-05 04:00:00"
                },
                "": {
                    "count": 5,
                    "last_match": "2021-01-10 03:45:00"
                },
                "International Club Friendly": {
                    "count": 4,
                    "last_match": "2020-09-12 23:00:00"
                },
                "Italy Super Cup": {
                    "count": 4,
                    "last_match": "2025-12-19 03:00:00"
                },
                "England Premier League": {
                    "count": 1,
                    "last_match": "2023-06-02 20:24:04"
                }
            },
            "logo_id": "1740880146189",
            "country": "it",
            "remark": "Associazione Calcio Milan: (Italian pronunciation: [assotʃatˈtsjoːne ˈkaltʃo ˈmiːlan]), commonly referred to as Milan or AC Milan (Italian pronunciation: [a tˌtʃi mˈmiːlan]) mainly outside of Italy, is an Italian professional football club based in Milan, Lombardy. Founded in 1899.",
            "created_datetime": "2025-05-07 14:59:14",
            "updated_datetime": "2026-09-14 08:01:01",
            "is_exact_match": "1"
        },
    ]
}

5.5 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football_teams" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "name=AC Milan" \
  --data-urlencode "type=1"

6. 滚球即时盘口与比分列表接口

大纲

6.1 接口概述H3

滚球（In-Play）即时比分与盘口接口。直连底层每秒级推送引擎，提供Bet365正在进行中的足球比赛实时状态、比赛分钟、实时比分；支持携带 preview=1 快速拉取独赢盘口快照；当传入具体 match_id 时，输出该场比赛的所有即时滚球盘口（包括大小球、亚盘、角球等全部滚球玩法赔率）。

6.2 请求方式H3

  • Method: GET
  • URL: /api/football_inplay

6.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
match_idstring否-比赛 ID。不传时返回全量正在进行中的滚球比赛列表；传入时返回该场全部实时盘口180710745
versionint否-版本号。如果发送版本号接口将只返回这个版本号之后的更新内容，不传版本号将会发送全部赔率1779355929797
previewint否0传 1 时（未传 match_id 场景），列表中额外挂载主客队即时独赢盘口（1-X-2）及联赛信息1

6.4 响应数据示例（滚球全场列表，preview=1）H3

JSON
{
  "msg": "success",
  "code": 0,
  "data": [
    {
      "match_id": "13126149",
      "league": "China U20 League",
      "home": "Shandong Taishan U20",
      "away": "Wuhan Three Towns U20",
      "TM": "45",
      "TS": "0",
      "TT": "0",
      "TU": "1789373803",
      "LS": "0-0",
      "full_time_result": [
        { "name": "1", "odds": "2.10"},
        { "name": "Draw", "odds": "3.20"},
        { "name": "2", "odds": "3.40"}
      ]
    }
  ]
}

6.5 核心时钟字段定义H3

  • TM: 比赛当前进行的分钟数（Minute）。
  • TS: 比赛当前进行的秒数（Second）。
  • TT: 计时器跑动状态（1: 正在走秒进行；0: 比赛暂停、中场休息或补时停顿）。
  • TU: 欧洲时区毫秒/秒级标准时间戳。
  • LS: 即时比分（Live Score），格式为 主队进球-客队进球。

6.6 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football_inplay" \
  --data-urlencode "token=YOUR_API_TOKEN"

7. 滚球 2D 现场动画与事件流接口

大纲

7.1 接口概述H3

专为 2D 虚拟绿茵球场打造的现场高频动画还原接口。将现场雷达采集的原始动作码（VC）翻译为自然多语言事件（支持主客队判定、第几次进攻/角球/进球计数），并将球场动作坐标归一化为 [0..1, 0..1] 浮点区间，便于前端 Canvas / WebGL 直接绘制球权走向与动画轨迹。

7.2 请求方式H3

  • Method: GET
  • URL: /api/football_inplay_live

7.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
match_idstring否-比赛 ID。不传时返回当前所有在场动画比赛简表；传入时返回单场高精度动画数据180710745
langstring否en动作事件多语言：cn（简体中文）、en（英文）cn

7.4 响应数据示例（单场 2D 动画流）H3

JSON
{
  "msg": "success",
  "code": 0,
  "data": {
    "PG": "1",
    "VC": "1-危险进攻_3",
    "XY": "0.78,0.45",
    "datetime": "2026-09-14 16:15:30",
    "MT": "1789373803|45:00",
    "TT": "1",
    "LS": "1-0"
  }
}

7.5 动画参数解析H3

  • PG: 当PG包含~代表点球大战的信息，不包含～就代表这里是球员名字。
  • VC: 动画动作，格式1:包含&，&后面的信息为判点球给哪个队，示例Attack&1-Penalty；格式2:包含，后面的信息为数量，示例1-Goal_2（还有YellowCard和RedCard；其余动作见下方说明。
  • XY: 归一化球场坐标，X 轴 0.00~1.00，Y 轴 0.00~1.00。
  • MT: 该参数提供比赛在特定时刻的“基准时间点”（时间戳 ｜分钟数），当前端检测到 TT=1 时，需根据“当前时间与基准时间戳的差值”累加至基准分钟数以实现动态计时，若 TT=0 或基准分钟数为 45:00/90:00 则停止跳动。。
  • TT: 走秒状态（1 为正在进行，0 为停止）。
  • LS: 实时比分格式为0-0。

7.6 VC动作H3

“ShootoutScore”:”射中点球”,

“ShootoutMiss”:”射失点球”,

“ShootoutToTake”:”点球”,

“DangerousAttack”:”危险进攻”,

“Attack”:”进攻”,

“InPossession”:”控球”,

“Goal”:”进球”,

“Corner”:”角球”,

“YellowCard”:”黄牌”,

“RedCard”:”红牌”,

“GoalKick”:”球门球”,

“Penalty”:”判点球给”,

“DangerousFreeKick”:”危险任意球”,

“FreeKick”:”任意球”,

“ShotOnTarget”:”射正球门”,

“ShotOffTarget”:”射偏球门”,

“Substitution”:”更换替补”,

“PenaltyMissed”:”射失点球”,

“Throw”:”掷界外球”,

“Injury”:”受伤”,

“Offside”:”越位”,

“PossibleGoal”:”可能进球”,

// VAR相关

“InProgress”:”审查中”,

“ReviewingRedCard”:”审查红牌”,

“ReviewingGoal”:”审查进球”,

“ReviewingPenalty”:”审查点球”,

“PossibleRedCard”:”可能红牌”,

“PossiblePenalty”:”可能点球”,

“CheckCompleteNoRedCard”:”无红牌”,

“CheckCompleteNoGoal”:”进球无效”,

“CheckCompleteNoPenalty”:”无点球”,

//比赛状态相关

“KickOff”:”上半场”,

“HalfTime”:”半场结束”,

“SecondHalf”:”下半场”,

“FullTime”:”全场结束”,

“StartExtraTime1”:”加时赛上半场”,

“ExtraTimeHalfTime”:”加时赛半场结束”,

“StartExtraTime2”:”加时赛下半场”,

“EndOfExtraTime”:”加时赛结束”,

“PenaltyShootout”:”点球大战”,

“InjuryTime”:”伤停补时”,

7.7 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football_inplay_live" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "match_id=13126149"

8. 赔降雷达与双维泊松 Pro AI 预测接口

大纲

8.1 接口概述H3

AI 预测与赔率剧烈变动预警雷达。集成双维泊松（Bivariate Poisson Pro）分布与 Dixon-Coles 算法，计算进球联合概率、标准胜率 rate 与高阶 AI 胜率 rate_pro、期望值 value 与 value_pro，并提供专业凯利公式仓位建议 bet_k 与 bet_k_pro。

8.2 请求方式H3

  • Method: GET
  • URL: /api/football_trends

8.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
marketstring否-盘口筛选：
1. all_standard（标准预测有效项）
2. all_pro（Pro AI 模型有效项）
3. 具体盘口代码：full_time_result、goal_line、asian_handicap，支持后缀 -pro		all_standard
outcome_keystring否-玩法选项过滤（如 1、X、2、over_2.5、under_2.5 等）under_3.5
match_idstring否-按比赛 ID 精确筛选180710745
leaguestring否-联赛英文名称过滤；传 hot 自动过滤热门星标联赛hot
countrystring否-国家过滤sa
datestring否>= 当前时间日期筛选（all、YYYY、YYYY-MM-DD）2026-09-15
hoursint否-配合开赛时间筛选未来几小时内的比赛（6、12、24、48）24
min_matchint否-历史样本数门槛，默认是不低于3场否则无法有效统计预测率5
oddsint否0传 1 时，同时附带 Bet365 赛前三大盘口的赔率数据（odds_more）1
sortstring否rate排序字段：rate、value、match_time、rate_pro、value_prorate
descint否1排序方向：1 为降序 DESC，0 为升序 ASC1
league_listint否0传 1 时聚合返回当前趋势结果中的联赛分布列表1
page_numint否1页码1
page_sizeint否1000每页条数（最大 1000）20

8.4 响应数据示例H3

JSON
{
    "msg": "success",
    "code": 0,
    "data": {
        "row": [
            {
                "match_id": "194919723",
                "match_time": "2026-05-23 15:00:00",
                "league_en": "Australia Western Australia Premier League",
                "home_en": "Fremantle City FC",
                "away_en": "Perth Glory NPL",
                "country": "au",
                "market": "team_total_goals",
                "outcome_key": "home_under_5.5",
                "rate": "100",
                "odds": "1.002",
                "value": "0.002",
                "rate_pro": "99.18",
                "value_pro": "-0.0062",
                "f": "0",
                "home_stats": {
                    "PPG": 1.4,
                    "Win %": 40,
                    "BTTS %": 60,
                    "Draw %": 20,
                    "Lost %": 40,
                    "Played": [
                        194582948,
                        193417623,
                        191887852,
                        189961266,
                        188772674
                    ],
                    "xG (AVG)": 3.3,
                    "xGA (AVG)": 2.97,
                    "xPTS (AVG)": 1.58,
                    "Scored (AVG)": 1.8,
                    "Scored 5.5+ %": 0,
                    "Conceded (AVG)": 1.4,
                    "Conceded 5.5+ %": 0,
                    "Failed to Score %": 40,
                    "Total Goals (AVG)": 3.2,
                    "Scored Under 5.5 %": 100,
                    "Conceded Under 5.5 %": 100
                },
                "home_overall_stats": {
                    "PPG": 1.07,
                    "Win %": 21,
                    "BTTS %": 79,
                    "Draw %": 43,
                    "Lost %": 36,
                    "Played": [
                        194582948,
                        194111555,
                        193417623,
                        192976109,
                        192185464,
                        191887852,
                        191058748,
                        191058733,
                        190653070,
                        189961266,
                        189331572,
                        188772674,
                        188390552,
                        187689710
                    ],
                    "xG (AVG)": 2.85,
                    "xGA (AVG)": 3.52,
                    "xPTS (AVG)": 1.15,
                    "Scored (AVG)": 1.71,
                    "Scored 5.5+ %": 0,
                    "Conceded (AVG)": 1.93,
                    "Conceded 5.5+ %": 0,
                    "Failed to Score %": 21,
                    "Total Goals (AVG)": 3.64,
                    "Scored Under 5.5 %": 100,
                    "Conceded Under 5.5 %": 100
                },
                "away_stats": {
                    "PPG": 1.29,
                    "Win %": 29,
                    "BTTS %": 100,
                    "Draw %": 43,
                    "Lost %": 29,
                    "Played": [
                        193417632,
                        191887856,
                        191058746,
                        191058727,
                        190653045,
                        189961281,
                        188772706
                    ],
                    "xG (AVG)": 3.43,
                    "xGA (AVG)": 3.35,
                    "xPTS (AVG)": 1.5,
                    "Scored (AVG)": 2,
                    "Scored 5.5+ %": 0,
                    "Conceded (AVG)": 2,
                    "Conceded 5.5+ %": 0,
                    "Failed to Score %": 0,
                    "Total Goals (AVG)": 4,
                    "Scored Under 5.5 %": 100,
                    "Conceded Under 5.5 %": 100
                },
                "away_overall_stats": {
                    "PPG": 1.58,
                    "Win %": 42,
                    "BTTS %": 92,
                    "Draw %": 33,
                    "Lost %": 25,
                    "Played": [
                        194508273,
                        194153318,
                        193417632,
                        191887856,
                        191058746,
                        191058727,
                        190653045,
                        189961281,
                        190042086,
                        189317999,
                        188772706,
                        188390554
                    ],
                    "xG (AVG)": 3.67,
                    "xGA (AVG)": 4.08,
                    "xPTS (AVG)": 1.3,
                    "Scored (AVG)": 2.08,
                    "Scored 5.5+ %": 0,
                    "Conceded (AVG)": 1.75,
                    "Conceded 5.5+ %": 0,
                    "Failed to Score %": 0,
                    "Total Goals (AVG)": 3.83,
                    "Scored Under 5.5 %": 100,
                    "Conceded Under 5.5 %": 100
                },
                "league_name": "澳大利亚西澳大利亚超级联赛",
                "league_image_id": "1741869568373",
                "league_country": "au",
                "hot": 0,
                "home_name": "弗里曼特尔城",
                "home_image_id": "1748567480836",
                "home_country": "au",
                "away_name": "珀斯荣耀",
                "away_image_id": "141538",
                "away_country": "au"
            },
        ]
    }
}

8.5 算法指标解析H3

  • rate: 基于历史战绩与统计学基础模型推算的胜率（百分制）。
  • rate_pro: 双维泊松 Pro AI 矩阵模型推算的胜率（百分制）。
  • value / value_pro: 价值期望差（$EV = Rate \times Odds - 1$）。$EV > 0$ 表明该投注项存在正期望价值。
  • bet_k / bet_k_pro: 凯利准则建议仓位比例。
  • f: 为1时代表70%以上的历史比赛xG数据为根据每场统计数据计算的近似xG数据。
  • _overall_stats: 代表不区分主客队时的统计数据。

8.6 cURL 调用示例H3

BASH
curl -G "https://sportapi.skjpt.com/api/football_trends" \
  --data-urlencode "token=YOUR_API_TOKEN" \
  --data-urlencode "market=all_standard" \
  --data-urlencode "page_size=2"

9. 自动算奖与注单结算接口

大纲

9.1 接口概述H3

面向注单结算与对账引擎的自动计奖结算接口。根据官方已完赛的比分数据、半场比分、角球/红黄牌技术统计，自动为指定盘口与注单项进行结算，计算注单盈亏比率 profit 并返回比分明细。

9.2 请求方式H3

  • Method: POST 或 GET（支持 application/x-www-form-urlencoded 及 application/json）
  • URL: /api/football_bet_result

9.3 请求参数H3

参数名类型必填默认值说明与取值范围示例
tokenstring是-授权凭证YOUR_API_TOKEN
match_idstring是-比赛 ID（对应比赛状态必须为完场 status = -1）180710745
market_keystring是-玩法盘口代码（见下方支持列表）full_time_result
bet_itemstring/object是-投注项参数定义（JSON 字符串或 JSON 对象）{"header":"1","odds":1.95}

9.4 支持的玩法盘口（market_key）与 bet_item 格式H3

  1. 独赢 / 全场胜平负 (full_time_result):
    • bet_item: {"header": "1", "odds": 1.95}（1: 主胜, X / Tie / Draw: 平局, 2: 客胜）
  2. 半场胜平负 (half_time_result):
    • bet_item: {"header": "1", "odds": 2.20}
  3. 亚洲让球盘 (asian_handicap / 1st_half_asian_handicap):
    • bet_item: {"header": "1", "handicap": "-0.5/-1.0", "odds": 1.975}
  4. 进球大小球 (goal_line / goals_over_under / 1st_half_goal_line):
    • bet_item: {"header": "Over", "handicap": "2.5", "odds": 1.90}
  5. 角球让球与大小 (corners_2_way / asian_handicap_corners / first_half_corners):
    • bet_item: {"header": "Over", "handicap": "9.5", "odds": 1.85}

9.5 响应数据示例H3

JSON
{
  "msg": "success",
  "code": 0,
  "data": {
    "profit": -1,
    "result": {
      "ft_score": "1-1",
      "h1_score": "0-1",
      "h2_score": "1-0"
    }
  }
}

9.6 盈亏判定规则（profit）H3

  • profit > 0: 赢单。金额净收益倍数为 profit（例如赔率 1.95 全赢时返回 0.95；若为赢半则返回 0.475）。
  • profit == 0: 走盘退本（Void / Push）。
  • profit == -0.5: 输半（Loss Half）。
  • profit == -1: 全输（Loss）。

9.7 cURL 调用示例H3

BASH
curl -X POST "https://sportapi.skjpt.com/api/football_bet_result" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "YOUR_API_TOKEN",
    "match_id": "11255767",
    "market_key": "full_time_result",
    "bet_item": {
      "header": "1",
      "odds": 1.95
    }
  }'