GET fixture

根据赛事 ID 获取单个赛事。响应包括赛事的详细信息,包括参赛方姓名、ID 以及外部提供商映射。此端点不返回该赛事的博彩公司赔率。

端点

GET /v4/fixture

请求参数

  • fixtureId* (string)赛事的唯一 ID(例如:id1000001761301153)。
  • language (string) (可选)翻译标签的语言代码(例如:en、de、es)。默认值为 en。

请求示例

GET /v4/fixture?fixtureId=id1000001761301153&language=en

示例响应

{
  "fixtureId": "id1000001761301153",
  "participant1Id": 35,
  "participant2Id": 34,
  "sportId": 10,
  "tournamentId": 17,
  "seasonId": 130281,
  "statusId": 0,
  "hasOdds": true,
  "startTime": "2026-04-13T19:00:00.000Z",
  "trueStartTime": null,
  "trueEndTime": null,
  "updatedAt": "2026-04-06T23:17:08.202Z",
  "externalProviders": {
    "betradarId": 61301153,
    "mollybetId": "2026-04-13,35,34",
    "opticoddsId": "20260413A1B2C3D4",
    "lsportsId": null,
    "txoddsId": null,
    "sofascoreId": 15676100,
    "betgeniusId": 13670012,
    "flashscoreId": "xK4pLm2n",
    "pinnacleId": 1626291706,
    "oddinId": null
  },
  "statusName": "Pre-Game",
  "participant1Name": "Liverpool FC",
  "participant1ShortName": "Liverpool",
  "participant1Abbr": "LIV",
  "participant2Name": "Manchester United",
  "participant2ShortName": "Man Utd",
  "participant2Abbr": "MNU",
  "sportName": "Soccer",
  "tournamentSlug": "premier-league",
  "categorySlug": "england",
  "categoryName": "England",
  "tournamentName": "Premier League"
}

响应字段说明

顶级字段

  • fixtureId (string) 赛事的内部唯一 ID。
  • participant1Id (number) 第一参赛方的 ID。
  • participant2Id (number) 第二参赛方的 ID。
  • sportId (number) 代表运动项目的 ID(例如:10 = 足球,12 = 网球)。
  • tournamentId (number) 赛事所属锦标赛的 ID。
  • seasonId (number|null) 赛季 ID(如适用)。
  • statusId (number) 赛事状态码(例如:0 = 赛前,1 = 已安排,2 = 进行中,3 = 已结束)。
  • hasOdds (boolean) 此赛事是否有可用的赔率数据。
  • startTime (string) 计划开始时间的 ISO 8601 时间戳(UTC)。
  • trueStartTime (string|null) 若与计划不同,则为实际开始时间(例如延迟开球)。
  • trueEndTime (string|null) 赛事的实际结束时间(如可用)。
  • updatedAt (string) 最后更新时间的 ISO 8601 时间戳(UTC)。
  • statusName (string) 可读的赛事状态(例如:「Pre-Game」、「In-Play」、「Ended」)。
  • participant1Name (string) 第一参赛方的全名。设置 language 参数时会被翻译。
  • participant1ShortName (string) 第一参赛方的短显示名称。设置 language 参数时会被翻译。
  • participant1Abbr (string) 第一参赛方的 3 字母缩写。设置 language 参数时会被翻译。
  • participant2Name (string) 第二参赛方的全名。设置 language 参数时会被翻译。
  • participant2ShortName (string) 第二参赛方的短显示名称。设置 language 参数时会被翻译。
  • participant2Abbr (string) 第二参赛方的 3 字母缩写。设置 language 参数时会被翻译。
  • sportName (string) 运动项目名称。
  • tournamentSlug (string) URL 友好的锦标赛标识符。
  • categorySlug (string) 赛事类别的 slug(例如:「england」)。
  • categoryName (string) 类别的显示名称(例如:「England」)。
  • tournamentName (string) 锦标赛全名(设置 language 参数时会被翻译)。
  • externalProviders (object) 第三方提供商的 ID。:
    • betradarId (number|null) 来自 Betradar feed 的 ID。
    • mollybetId (string|null) Mollybet 复合标识符。
    • opticoddsId (string|null) OpticOdds 标识符。
    • lsportsId (number|null) LSports 标识符。
    • txoddsId (number|null) TXOdds 标识符。
    • sofascoreId (number|null) Sofascore 赛事 ID。
    • betgeniusId (number|null) Betgenius 赛事 ID。
    • flashscoreId (string|null) Flashscore 赛事 ID。
    • pinnacleId (number|null) Pinnacle 内部赛事 ID。
    • oddinId (number|null) Oddin 赛事 ID。

备注

  • 端点冷却时间 (速率限制):500ms
  • 所有时间戳均为 UTC(ISO 8601)。
  • 此端点不包含博彩公司赔率。请使用 /v4/odds 端点获取赛事的赔率。
上一页GET fixtures
下一页GET markets
报告问题
OddsPapi | 文档 GET fixture