跳转到主要内容

​
数据流内容

给定 fixtureId 的元数据 — 包括比赛状态、开始时间、参赛方和赛事/运动信息。 还包括可选的 scores 和映射的供应商ID。 这是用于将赔率/比分映射到实际赛事的锚定数据流。

​
路由

  • 实体键：payload.fixtureId
  • 过滤器：sportIds、tournamentIds、fixtureIds
  • 访问权限：由您的 apiKey 决定直播/赛前

​
负载字段

字段类型描述
fixtureIdstring赛事唯一ID
statusobject比赛状态信息
status.liveboolean是否正在直播
status.statusIdnumber | null可选状态码
status.statusNamestring | null状态名称（如 “Live”、“Postponed”）
sportobject运动元数据
sport.sportIdnumber运动唯一ID
sport.sportNamestring运动名称
tournamentobject赛事元数据
tournament.tournamentIdnumber赛事唯一ID
tournament.tournamentNamestring赛事名称
tournament.categoryNamestring地理/组织分类
seasonobject赛季元数据
season.seasonIdnumber | null赛季ID（可为空）
season.seasonNamestring | null赛季名称
startTimenumber预定开始时间（UTC纪元秒）
trueStartTimestring | null实际开始时间（ISO 8601）
trueEndTimestring | null实际结束时间（ISO 8601）
participantsobject参赛方元数据
participants.participant1Idnumber队伍/选手1 ID
participants.participant1Namestring队伍/选手1 名称
participants.participant1Abbrstring | null可选缩写
participants.participant1RotNrnumber | null可选轮换号
participants.participant2Idnumber队伍/选手2 ID
participants.participant2Namestring队伍/选手2 名称
participants.participant2Abbrstring | null可选缩写
participants.participant2RotNrnumber | null可选轮换号
scoresobject可选比分对象（与 scores 流格式相同）
expectedPeriodsnumber | null预定节数（如半场/盘/节）
periodLengthnumber | null每节时长（分钟）
externalProvidersobject映射的供应商ID
externalProviders.betradarIdnumber | nullBetradar 赛事ID
externalProviders.flashscoreIdstring | nullFlashscore ID
externalProviders.pinnacleIdnumber | nullPinnacle 赛事ID
externalProviders.sofascoreIdnumber | nullSofascore ID
externalProviders.oddinIdnumber | nullOddin ID
externalProviders.mollybetIdstring | nullMollybet ID
externalProviders.opticoddsIdstring | nullOpticodds ID
externalProviders.lsportsIdnumber | nullLSports ID
externalProviders.txoddsIdnumber | nullTXOdds ID

​
示例消息（JSON）

{
  "channel": "fixtures",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1000046363014481",
    "status": {
      "live": true,
      "statusId": 1,
      "statusName": "Live"
    },
    "sport": {
      "sportId": 10,
      "sportName": "Soccer"
    },
    "tournament": {
      "tournamentId": 463,
      "tournamentName": "AFC Champions League Elite",
      "categoryName": "International Clubs"
    },
    "season": {
      "seasonId": 131657,
      "seasonName": "AFC Champions League Elite 25/26"
    },
    "startTime": 1766427300,
    "trueStartTime": "2025-12-22T18:15:38.441757+00:00",
    "trueEndTime": null,
    "participants": {
      "participant1Id": 61532,
      "participant1RotNr": null,
      "participant1Name": "Al Shorta SC",
      "participant1Abbr": null,
      "participant2Id": 34469,
      "participant2RotNr": null,
      "participant2Name": "Al Ahli Saudi FC",
      "participant2Abbr": null
    },
    "scores": {},
    "expectedPeriods": null,
    "periodLength": null,
    "externalProviders": {
      "betgeniusId": 12860147,
      "betradarId": 63014481,
      "flashscoreId": "hUsabPpR",
      "mollybetId": "2025-12-22,29690,26898",
      "oddinId": null,
      "opticoddsId": "20251222AF56C9CD",
      "pinnacleId": 1621307620,
      "sofascoreId": 14466133,
      "lsportsId": null,
      "txoddsId": null
    }
  },
  "ts": 1766427338743,
  "entryId": "1766427338743-4273"
}

​
示例：包含 scores.result 的赛事更新

某些赛事更新包含 scores 对象（例如赛前或结果快照）。 
{
  "channel": "fixtures",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1102138464027567",
    "status": {
      "live": false,
      "statusId": 0,
      "statusName": "Pre-Game"
    },
    "sport": {
      "sportId": 11,
      "sportName": "Basketball"
    },
    "tournament": {
      "tournamentId": 21384,
      "tournamentName": "NCAA Women, Regular Season",
      "categoryName": "USA"
    },
    "season": {
      "seasonId": 133208,
      "seasonName": "NCAA Women, Regular Season 25/26"
    },
    "startTime": 1766426400,
    "trueStartTime": "2025-12-22T18:03:13.535381+00:00",
    "trueEndTime": null,
    "participants": {
      "participant1Id": 347062,
      "participant1RotNr": null,
      "participant1Name": "Sam Houston State Bearkats",
      "participant1Abbr": null,
      "participant2Id": 346978,
      "participant2RotNr": null,
      "participant2Name": "Northern Colorado Bears",
      "participant2Abbr": null
    },
    "scores": {
      "result": {
        "period": "result",
        "participant1Score": 7,
        "participant2Score": 2,
        "updatedAt": "2025-12-22T18:12:16.755551+00:00"
      }
    },
    "expectedPeriods": null,
    "periodLength": null,
    "externalProviders": {
      "betgeniusId": null,
      "betradarId": 64027567,
      "flashscoreId": "lxgZJCUG",
      "mollybetId": null,
      "oddinId": null,
      "opticoddsId": null,
      "pinnacleId": null,
      "sofascoreId": null,
      "lsportsId": null,
      "txoddsId": null
    }
  },
  "ts": 1766427343630,
  "entryId": "1766427343630-4278"
}