跳转到主要内容
我们持续改进Odds API。 此页面列出新功能变更修复重大变更
所有时间戳均为UTC。 如果变更影响数据形状或行为,将标记为重大变更

2026-04-09

新增

  • 赛事视图:venue 场馆部分 — 所有赛事响应新增嵌套对象,包含 venueIdvenueNamevenueLocation。按语言翻译。
  • 赛事视图:clock 时钟部分 — 所有赛事响应新增嵌套对象,包含 currentPeriodcurrentTimeremainingTimeremainingTimeInPeriodstopped。在赛事填充时钟数据之前,所有键均为 null
  • 赛事视图:participant1ShortName / participant2ShortName — 赛事响应 participants 部分新增字段,来源于翻译后的参赛方数据。
  • 赛事视图:seasonRound — 赛事响应 season 部分新增字段。
  • 期货视图:marketId — 期货响应 market 部分现包含来自期货表的 marketId。名称字段(marketNamemarketTypeplayerMarketparticipantMarket)暂时为 null
  • 参赛方端点:participantShortNameGET /{lang}/participants 响应现包含每个参赛方的 participantShortName
  • 新REST端点:GET /{lang}/venues?venueIds=... — 返回带有翻译后 venueNamevenueLocation 的场馆数据。
  • 新WebSocket频道:clocks — 按赛事传递实时时钟更新(与 scores 相同的路由:按 fixtureId、运动、赛事过滤)。支持恢复/重放。

重大变更

  • 赛事响应结构变更 — 所有赛事端点(REST和WebSocket)现包含三个新顶级键:venue(对象)、clock(对象),以及更新的 participants / season 部分。严格解析赛事响应的客户端应更新其模型。
    • season 现包含 seasonRound: integer | null
    • participants 现包含 participant1ShortName: string | nullparticipant2ShortName: string | null
    • venue: { venueId, venueName, venueLocation }season 之后添加
    • clock: { currentPeriod, currentTime, remainingTime, remainingTimeInPeriod, stopped }scores 之后添加
  • 期货响应结构变更market.marketId 现已填充(整数或null),不再始终为 null

2025-12-12

新增

  • WebSocket 恢复和重放支持,使用entryId游标
  • 新WebSocket频道:
    • injuries
    • lineups
    • stats
  • WebSocket网关的AsyncAPI 3.0参考

改进

  • 减少了oddsscores的WebSocket延迟
  • 改进了sportIdstournamentIdsbookmakers的过滤

修复

  • 修复了一些odds更新在没有博彩公司门控的情况下交付的问题
  • 修复了某些赛事在过渡期间live标志不正确的问题

2025-11-28

重大变更

  • odds.payload.odds键现在始终是博彩公司范围的
    • 期望扁平结构的旧客户端必须更新

新增

  • 支持receiveType: "binary"(MessagePack)
  • 在所有更新消息中添加了entryId

2025-11-10

新增

  • 初始WebSocket网关
  • 频道:
    • fixtures
    • scores
    • odds
    • bookmakers