> ## 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流式传输每个期货市场的博彩商状态。跟踪哪些体育博彩提供赛季投注赔率并检测市场暂停。

## 数据流内容

描述博彩商是否为给定期货提供赔率的每个博彩商元数据，以及这些赔率是激活的、过期的还是暂停的。

这是赛事 `bookmakers` 频道的**期货等效版本**。

***

## 路由

* 实体键：`payload.futureId`
* 过滤器：`sportIds`、`tournamentIds`、`futureIds`、`bookmakers`
* 访问权限：由您的 `apiKey` 决定
* 博彩商授权：✅ 是

***

## 负载结构

| 字段                                  | 类型               | 描述                                         |
| ----------------------------------- | ---------------- | ------------------------------------------ |
| `futureId`                          | `string`         | 此更新适用的期货                                   |
| `bookmakers`                        | `object`         | `<bookmaker>` → 元数据对象的映射                   |
| `bookmakers.<bk>.bookmaker`         | `string`         | 博彩商标识（如 `"stake"`、`"pinnacle"`）            |
| `bookmakers.<bk>.bookmakerFutureId` | `string \| null` | 可选的博彩商侧期货标识符                               |
| `bookmakers.<bk>.futurePath`        | `string \| null` | 可选的博彩商期货深链接或路径                             |
| `bookmakers.<bk>.hasOdds`           | `boolean`        | 博彩商当前是否提供赔率                                |
| `bookmakers.<bk>.staleOdds`         | `boolean`        | **交易关键字段。** 与该博彩商的连接已断开，赔率新鲜度无法保证时为 `true` |
| `bookmakers.<bk>.suspended`         | `boolean`        | 博彩商是否已暂停此期货                                |
| `bookmakers.<bk>.meta`              | `object \| null` | 可选的博彩商特定元数据                                |
| `bookmakers.<bk>.updatedAt`         | `string`         | 最后更新时间戳（ISO 8601）                          |

***

## 示例消息

```json theme={null}
{
  "channel": "bookmakersFutures",
  "type": "UPDATE",
  "payload": {
    "futureId": "id11028543137888",
    "bookmakers": {
      "stake": {
        "bookmaker": "stake",
        "bookmakerFutureId": "285431-nbl-new-zealand",
        "futurePath": null,
        "hasOdds": true,
        "staleOdds": false,
        "suspended": false,
        "meta": null,
        "updatedAt": "2025-12-28T18:37:13.719926+00:00"
      }
    }
  },
  "ts": 1766947033889,
  "entryId": "1766947033889-501"
}
```

***

## 自动化交易关键字段

### `staleOdds` — 赔率新鲜度保证

<Warning>
  如果您在 OddsPapi 之上运行自动化交易策略，`staleOdds` 是您必须检查的最重要字段之一。
</Warning>

当 `staleOdds = true` 时，OddsPapi 与该博彩商之间的连接已**断开或中断**。这意味着：

* 您之前收到的赔率**可能不再反映博彩商的当前价格**
* 在连接恢复之前，无法保证进一步的更新
* 您应该**立即暂停**该博彩商的任何自动化投注逻辑
* 将该博彩商的所有现有赔率视为**未验证**，直到 `staleOdds` 恢复为 `false`

***

## 说明

* 赔率数据本身通过 **`oddsFutures`** 流式传输
* 如果博彩商不在 `bookmakers` 中，假设**当前没有赔率**
* 将此频道用作处理 `oddsFutures` 频道赔率之前的**预过滤器**
* 结合 `staleOdds`、`suspended` 和 `hasOdds` 来判断博彩商的赔率是否可信
* 语义与 `bookmakers`（赛事级别）故意相同，只是范围限定为 `futureId`