时钟频道 - 实时比赛时钟更新 - OddsPapi API

数据流内容

按特定 fixtureId 的实时时钟更新。每条消息包含直播比赛的当前时钟状态 — 节、已用/剩余时间以及时钟是否暂停。

路由

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

负载字段

字段	类型	描述
`fixtureId`	`string`	此时钟对应的赛事
`clock`	`object`	时钟状态
`clock.currentPeriod`	`string \| null`	当前节（如 `"p1"`、`"p2"`）
`clock.currentTime`	`string \| null`	当前比赛时间
`clock.remainingTime`	`string \| null`	比赛剩余时间
`clock.remainingTimeInPeriod`	`string \| null`	当前节剩余时间
`clock.stopped`	`boolean \| null`	时钟是否暂停

示例消息（JSON）

{
  "channel": "clocks",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1500023462078980",
    "clock": {
      "currentPeriod": "p2",
      "currentTime": null,
      "remainingTime": "26:42",
      "remainingTimeInPeriod": "2:42",
      "stopped": false
    }
  },
  "ts": 1775170900000,
  "entryId": "1775170900000-42"
}

说明

时钟更新独立于 scores 和 fixtures 传递
clock 对象也包含在 fixtures 频道的负载中（作为赛事快照的一部分）
当没有时钟数据时，所有字段均为 null
使用此频道获取高频时钟状态，无需接收完整的赛事负载