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

# WebSocket 行情频道 - bookmakers、currencies、fixtures、scores、clocks、odds

> Apexium API WebSocket 行情频道的工作方式：从 /v1/{lang} 加载状态，应用变化，收到 snapshot_required 时重新加载。

行情频道传送 OddsPapi v5 行情数据。它们的数据内容就是 OddsPapi 的，只有博彩公司被限制为您账户的博彩公司。

## 频道

| 频道 | 内容 | 数据内容的逐字段说明 |
| - | - | - |
| `bookmakers` | 赛事上博彩公司层面的变化 | [OddsPapi `bookmakers`](https://docs.oddspapi.io/websocket/channels/bookmakers) |
| `currencies` | 汇率 | [OddsPapi `currencies`](https://docs.oddspapi.io/websocket/channels/currencies) |
| `fixtures` | 赛事变化：时间、状态、参赛方 | [OddsPapi `fixtures`](https://docs.oddspapi.io/websocket/channels/fixtures) |
| `scores` | 比分变化 | [OddsPapi `scores`](https://docs.oddspapi.io/websocket/channels/scores) |
| `clocks` | 比赛时钟变化 | [OddsPapi `clocks`](https://docs.oddspapi.io/websocket/channels/clocks) |
| `odds` | 您的博彩公司的赔率变化 | [OddsPapi `odds`](https://docs.oddspapi.io/websocket/channels/odds) |

[OddsPapi WebSocket 频道](https://docs.oddspapi.io/websocket/channels)文档对它们作了整体说明。

## 先加载，再应用变化

行情频道**只传送变化**。它们从不发送赛事的当前状态。请分三步构建状态：

**1. 连接并登录**

打开连接，用您需要的频道和赛事登录。保留从此刻起到达的消息。

**2. 加载状态**

从 `/v1/{lang}` 读取赛事及其赔率，例如 [`GET /v1/en/fixtures/odds`](https://docs.apexiumbet.com/zh/api-reference/market-data)。

**3. 应用变化**

在已加载的状态之上，先应用您保留的消息，再应用之后的每条新消息。

先连接后加载，就不会在两者之间丢失任何变化。已经包含在加载状态中的变化，再应用一次也无妨。

## 收到 `snapshot_required` 时重新加载

当 Apexium 无法保证您收到了每一个变化时，它会告诉您需要重新加载哪些频道：

```json theme={null}
{ "type": "snapshot_required", "reason": "feed_interrupted", "channels": ["odds", "scores"] }
```

请从 `/v1/{lang}` 重新加载这些频道的状态，然后继续应用消息。以下情况会发生这种情形：

* **行情来源中断**，Apexium 刚刚重新订阅。
* **Apexium 落后于行情**超过一秒：它会丢弃来不及发送的内容，而不是发送过时的价格，并要求受影响的客户端重新加载。

在 `snapshot_required` 之前发送的每条消息都比您重新加载的状态更旧。

一个连接每 10 秒最多收到一次 `snapshot_required`，以便您有时间重新加载。在这 10 秒内需要重新加载的频道，会在 10 秒结束时合并到一条 `snapshot_required` 中发送。

## 您会收到什么

* **`odds` 和 `bookmakers`** 只针对您 `fixtureIds` 中的赛事。关注某项运动或某个联赛不会带来其赔率。
* **`fixtures`、`scores` 和 `clocks`** 针对您的 `fixtureIds`，以及您 `tournamentIds` 和 `sportIds` 中的每场赛事。
* **`currencies`** 发给订阅该频道的每个连接。
* **博彩公司。** 赔率只包含您账户的博彩公司，对 API 关闭的除外。不含其中任何一家的消息不会发送。
* **语言。** `fixtures` 遵循您登录时的 `lang`。参见[语言](https://docs.apexiumbet.com/zh/websocket/overview.md#语言)。

赔率占行情数据的大部分，因此您需要逐场赛事关注赔率，并受账户[赛事限制](https://docs.apexiumbet.com/zh/websocket/close-codes.md#4004)的约束。要交易整个联赛：

1. 在 `fixtures` 上用该联赛的 `tournamentIds` 登录，或从 `/v1/{lang}` 读取其赛事。
2. 发送 `{ "type": "subscribe", "fixtureIds": [...] }`，带上您要交易的赛事，它们的赔率随即开始推送。
3. 赛事结束后，为其发送 `unsubscribe`，以释放名额。

## 读取过慢会被关闭

Apexium 向每个客户端发送其能承受的数据量。发送缓冲区持续满载的连接会以 `4002` 关闭，其他客户端不会因此变慢。参见[关闭代码](https://docs.apexiumbet.com/zh/websocket/close-codes.md#4002)。

要跟上数据流：

* **使用 `zstd`。** 它可将数据流缩小约四倍。参见[编码](https://docs.apexiumbet.com/zh/websocket/encodings.md)。
* **在独立任务中读取。** 快速解码并保存每条消息；把定价或数据库写入等耗时工作放到其他地方。
* **只关注您用到的内容。** `fixtureIds` 中的每场赛事都会把它的赔率加入您的数据流。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.