跳转到主要内容

​
数据流内容

关于长期或赛季投注市场（称为”期货”）的元数据，以 futureId 为范围。 包括赛事/赛季映射、盘口元数据、时间窗口和外部供应商ID。

​
路由

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

​
负载字段

字段类型描述
futureIdstring期货的唯一标识符
statusobject直播/赛前状态
status.liveboolean期货当前是否为直播
status.statusIdnumber | null可选状态码
status.statusNamestring | null可选状态标签（如 "Pre-Game"、"Live"）
sportobject运动元数据
sport.sportIdnumber运动唯一ID
sport.sportNamestring运动名称
tournamentobject赛事元数据
tournament.tournamentIdnumber赛事唯一ID
tournament.tournamentNamestring赛事名称
tournament.categoryNamestring地理/组织分组
seasonobject赛季元数据
season.seasonIdnumber | null赛季ID（可为空）
season.seasonNamestring | null赛季名称
startTimenumber投注窗口开始时间（UTC纪元秒）
endTimenumber投注窗口结束时间（UTC纪元秒）
marketobject | null盘口元数据（可为空）
market.marketIdnumber | null可选盘口ID
market.marketNamestring | null可选盘口名称（如 "Outright Winner"）
market.marketTypestring | null可选盘口类型代码
market.playerMarketboolean | null是否为选手特定盘口
market.participantMarketboolean | null是否为参赛方/队伍盘口
externalProvidersobject映射的外部供应商ID
externalProviders.betradarIdnumber | nullBetradar ID
externalProviders.flashscoreIdstring | nullFlashscore ID
externalProviders.opticoddsIdstring | nullOpticOdds ID
externalProviders.polymarketIdstring | nullPolymarket ID
externalProviders.kalshiIdstring | nullKalshi ID
externalProviders.sofascoreIdnumber | nullSofascore ID
bookmakersobject赔率可用状态（参见 bookmakersFutures）

​
示例：期货元数据

{
  "channel": "futures",
  "type": "UPDATE",
  "payload": {
    "futureId": "id11047437137982",
    "status": {
      "live": true,
      "statusId": 1,
      "statusName": "Live"
    },
    "sport": {
      "sportId": 11,
      "sportName": "Basketball"
    },
    "tournament": {
      "tournamentId": 47437,
      "tournamentName": "NBL",
      "categoryName": "China"
    },
    "season": {
      "seasonId": 137982,
      "seasonName": "NBL 25/26"
    },
    "startTime": 1766188800,
    "endTime": 1777334399,
    "market": {
      "marketId": null,
      "marketName": null,
      "marketType": null,
      "playerMarket": null,
      "participantMarket": null
    },
    "externalProviders": {
      "betradarId": 137982,
      "flashscoreId": null,
      "opticoddsId": null,
      "polymarketId": null,
      "kalshiId": null,
      "sofascoreId": null
    },
    "bookmakers": {}
  },
  "ts": 1766939800000,
  "entryId": "1766939800000-999"
}

​
说明

  • 赔率通过 oddsFutures 频道单独流式传输
  • 使用 futureId 关联：
    • oddsFutures（获取价格）
    • bookmakersFutures（获取每个博彩商的状态）
  • 大多数 market 字段对于遗留或非结构化市场可能为 null