GET fixtures

根据指定参数（如锦标赛 ID、体育项目 ID、参赛方 ID、日期范围和语言）获取比赛列表。

端点

GET /v4/fixtures

请求

参数

• tournamentId (number) — 锦标赛的唯一标识符。该 ID 必须对应一个已存在的锦标赛。
• sportId (number) — 体育项目的唯一标识符。该 ID 必须对应一个已存在的体育项目。
• participantId (number) — 参赛方的唯一标识符。该 ID 必须对应一个已存在的参赛方。
• from (string) — 比赛起始时间（ISO 8601 格式）。 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• to (string) — 比赛结束时间（ISO 8601 格式）。 (e.g., YYYY-MM-DDTHH:MM:SSZ)
• language (a2) — （可选）返回锦标赛信息所使用的语言。默认值为 en for English
• statusId (number: 0,1,2,3) — 返回比赛应具有的 statusId（0：未开始，1：进行中，2：已结束，3：已取消）。
• hasOdds (boolean) — 指示此比赛是否有可用赔率。
• bookmakers (string) — （可选）以逗号分隔的博彩公司 slug 列表。用于评估 hasOdds 过滤器。

条件

• tournamentId: 可以作为唯一提供的参数。
• participantId: 可以作为唯一提供的参数。
• sportId: 必须与以下任一参数一起使用：:
  • tournamentId
  • participantId
  • 两者 to 以及 from, 两者的时间差必须在 10 天以内。
• to 以及 from:
  • 如果 tournamentId 或 participantId 被同时提供， to and from 它们并非必填，仅提供其中一个也是允许的。
  • 如果仅有 to 以及 from 被提供，则二者时间差必须小于 48 小时。

请求示例

GET /v4/fixtures?sportId=10&from=2026-04-12&to=2026-04-17&statusId=0&hasOdds=true&bookmakers=pinnacle

响应示例

[
  {
    "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"
  }
]

响应 (200 OK)

当请求成功时，服务器会返回状态码 200 并返回一个包含以下字段的比赛对象 JSON 数组：:

• fixtureId (string) — 比赛的唯一标识符。
• participant1Id (number) — 第一参赛方的 ID。
• participant2Id (number) — 第二参赛方的 ID。
• sportId (number) — 与比赛关联的体育项目 ID。
• tournamentId (number) — 与比赛关联的锦标赛 ID。
• seasonId (number|null) — （可选）赛季 ID。
• statusId (number) — 比赛的当前状态。
• hasOdds (boolean) — 指示此比赛是否有可用赔率。
• startTime (string) — 比赛开始时间。
• trueStartTime (string|null) — 比赛实际开始时间（如果可用）。
• trueEndTime (string|null) — 比赛实际结束时间（如果可用）。
• updatedAt (string) — 比赛最后更新时间戳。
• statusName (string) — 可读的赛事状态（例如：「Pre-Game」、「In-Play」、「Ended」）。
• participant1Name (string) — 第一参赛方名称（使用你请求的语言）。
• participant1ShortName (string) — 第一参赛方的短显示名称。设置 language 参数时会被翻译。
• participant1Abbr (string) — 第一参赛方的 3 字母缩写。设置 language 参数时会被翻译。
• participant2Name (string) — 第二参赛方名称（使用你请求的语言）。
• participant2ShortName (string) — 第二参赛方的短显示名称。设置 language 参数时会被翻译。
• participant2Abbr (string) — 第二参赛方的 3 字母缩写。设置 language 参数时会被翻译。
• sportName (string) — 与比赛关联的体育项目名称。
• tournamentSlug (string) — URL 友好的锦标赛标识符。
• categorySlug (string) — 赛事类别的 slug（例如：「england」）。
• categoryName (string) — 锦标赛所属类别名称。
• tournamentName (string) — 锦标赛名称。
• externalProviders (object) — 来自第三方供应商的 ID:
  • betradarId (number|null) — （可选）由 Betradar 分配的 ID。
  • mollybetId (string|null) — （可选）由 Mollybet 分配的唯一 ID。
  • opticoddsId (string|null) — （可选）由 Opticodds 分配的唯一 ID。
  • lsportsId (number|null) — （可选）由 LSports 分配的唯一 ID。
  • txoddsId (number|null) — （可选）由 TXOdds 分配的唯一 ID。
  • 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。