跳转到主要内容

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.

​
数据流内容

关于哪些博彩商为给定赛事提供赔率的元数据，以及这些赔率是激活的、过期的、暂停的还是轮换的。 此数据流通过为每个 fixtureId 提供每个博彩商的状态来补充 odds 频道。

​
路由

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

​
负载结构

字段类型描述
fixtureIdstring此更新适用的赛事
bookmakersobject<bookmaker> → 元数据对象的映射
bookmakers.<bk>.bookmakerstring博彩商标识（如 "stake"、"pinnacle"）
bookmakers.<bk>.bookmakerFixtureIdstring | null可选的博彩商侧ID（可能是标识或复合字符串）
bookmakers.<bk>.fixturePathstring | null可选的博彩商路径或UI路由（如支持）
bookmakers.<bk>.hasOddsboolean博彩商当前是否提供任何赔率
bookmakers.<bk>.staleOddsboolean交易关键字段。 与该博彩商的连接已断开，赔率新鲜度无法保证时为 true
bookmakers.<bk>.staleOddsResponseCodenumber | null过期检查时返回的HTTP状态码
bookmakers.<bk>.suspendedboolean此博彩商的赔率是否已暂停
bookmakers.<bk>.participantsRotatedboolean该博彩商的主客场分配与 OddsPapi 基准不同时为 true（详见下文）
bookmakers.<bk>.metaobject | null可选元数据（博彩商特定）
bookmakers.<bk>.updatedAtstring最后更新时间戳（ISO 8601）

​
示例消息

{
  "channel": "bookmakers",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1000070367118324",
    "bookmakers": {
      "draftkings": {
        "bookmaker": "draftkings",
        "bookmakerFixtureId": "33999242",
        "fixturePath": "https://sportsbook.draftkings.com/event/33999242",
        "hasOdds": true,
        "staleOdds": false,
        "staleOddsResponseCode": null,
        "suspended": false,
        "participantsRotated": false,
        "meta": null,
        "updatedAt": "2026-04-21T00:51:48.283641+00:00"
      }
    }
  },
  "ts": 1776729708000,
  "entryId": "1776729708000-1"
}

​
自动化交易关键字段

​
staleOdds — 赔率新鲜度保证

如果您在 OddsPapi 之上运行自动化交易或套利策略，staleOdds 是您必须检查的最重要字段之一。
当 staleOdds = true 时，OddsPapi 与该博彩商之间的连接已断开或中断。这意味着：
  • 您之前收到的赔率可能不再反映博彩商的当前价格
  • 在连接恢复之前，无法保证进一步的更新
  • 您应该立即暂停该博彩商的任何自动化投注或套利逻辑
  • 将该博彩商的所有现有赔率视为未验证，直到 staleOdds 恢复为 false
staleOddsResponseCode 提供触发过期检测的 HTTP 状态码（如有）— 用于调试连接问题。

​
participantsRotated — 主客场映射

当 participantsRotated = true 时，该博彩商将不同的队伍视为主队，与 OddsPapi 的基准不同。换句话说，participant1（主队）和 participant2（客队）在该博彩商处与 OddsPapi 基准赛事相比是互换的。 这对以下方面至关重要：
  • 独赢 / 1x2 盘口 — “主队”和”客队”结果含义相反
  • 让分 / 让球盘 — 让分的正负号翻转
  • 任何自动化策略 — 按参赛方位置而非参赛方 ID 映射结果
如果您在 OddsPapi 之上构建系统，请始终检查此标志，并在其为 true 时交换该博彩商的参赛方映射。

​
说明

  • 如果博彩商不在 bookmakers 中，假设该赛事当前没有可用赔率。
  • 将此频道用作处理 odds 频道赔率之前的预过滤器。
  • 结合 staleOdds、suspended 和 hasOdds 来判断博彩商的赔率在任何给定时刻是否可信。