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) — 指示此比赛是否有可用赔率。

条件

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

请求示例

GET /v4/fixtures?sportId=10&from=2025-07-14T00:00:00Z&to=2025-07-21T00:00:00Z&hasOdds=true

响应示例

[
  {
    "fixtureId": "id1000015561098461",
    "participant1Id": 3209,
    "participant2Id": 3210,
    "providerId": 61098461,
    "seasonId": 127421,
    "sportId": 10,
    "startTime": "2025-07-21T00:00:00.000Z",
    "statusId": 2,
    "tournamentId": 155,
    "trueEndTime": "2025-07-21T01:58:12.073Z",
    "trueStartTime": "2025-07-21T00:00:02.751Z",
    "updatedAt": "2025-07-21T01:58:12.073Z",
    "hasOdds": true,
    "externalProviders": {
      "betradarId": 61098461,
      "sofascoreId": 14069376,
      "betgeniusId": 11833149,
      "flashscoreId": "pbXYexxB",
      "pinnacleId": 1611618343,
      "oddinId": null,
      "mollybetId": null,
      "opticoddsId": null,
      "lsportsId": null,
      "txoddsId": null
    },
    "participant1Name": "CA Independiente Avellaneda",
    "participant2Name": "CA Talleres de Cordoba",
    "tournamentName": "Liga Profesional",
    "categoryName": "Argentina"
  }
]

响应 (200 OK)

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

• hasOdds (boolean) — 指示此比赛是否有可用赔率。
• startTime (string) — 比赛开始时间。
• participant1Id (number) — 第一参赛方的 ID。
• participant2Id (number) — 第二参赛方的 ID。
• fixtureId (string) — 比赛的唯一标识符。
• sportId (number) — 与比赛关联的体育项目 ID。
• sportName (string) — 与比赛关联的体育项目名称。
• updatedAt (string) — 比赛最后更新时间戳。
• tournamentId (number) — 与比赛关联的锦标赛 ID。
• seasonId (number) — （可选）赛季 ID。
• statusId (number) — 比赛的当前状态。
• trueStartTime (string|null) — 比赛实际开始时间（如果可用）。
• trueEndTime (string|null) — 比赛实际结束时间（如果可用）。
• externalProviders (object) — 来自第三方供应商的 ID:
  • betradarId (number|null) — （可选）由 Betradar 分配的 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。
  • mollybetId (number|null) — （可选）由 Mollybet 分配的唯一 ID。
  • opticoddsId (number|null) — （可选）由 Opticodds 分配的唯一 ID。
  • lsportsId (number|null) — （可选）由 LSports 分配的唯一 ID。
  • txoddsId (number|null) — （可选）由 TXOdds 分配的唯一 ID。
• participant1Name (string) — 第一参赛方名称（使用你请求的语言）。
• participant2Name (string) — 第二参赛方名称（使用你请求的语言）。
• tournamentName (string) — 锦标赛名称。
• categoryName (string) — 锦标赛所属类别名称。