> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 时钟频道 - 实时比赛时钟更新

> 通过WebSocket流式传输实时比赛时钟更新。节、剩余时间和暂停状态。

## 数据流内容

按特定 `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）

```json theme={null}
{
  "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`
* 使用此频道获取高频时钟状态，无需接收完整的赛事负载