期货博彩商频道 - 赛季市场博彩商状态 - OddsPapi API

数据流内容

描述博彩商是否为给定期货提供赔率的每个博彩商元数据，以及这些赔率是激活的、过期的还是暂停的。这是赛事 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）

示例消息

{
  "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` — 赔率新鲜度保证

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

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

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

说明

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