数据流内容
关于哪些博彩商为给定赛事提供赔率的元数据,以及这些赔率是激活的、过期的、暂停的还是轮换的。
此数据流通过为每个 fixtureId 提供每个博彩商的状态来补充 odds 频道。
- 实体键:
payload.fixtureId
- 过滤器:
sportIds、tournamentIds、fixtureIds、bookmakers
- 访问权限:由您的
apiKey 决定
- 博彩商授权:✅ 是
负载结构
示例消息
自动化交易关键字段
staleOdds — 赔率新鲜度保证
如果您在 OddsPapi 之上运行自动化交易或套利策略,staleOdds 是您必须检查的最重要字段之一。
当 staleOdds = true 时,OddsPapi 与该博彩商之间的连接已断开或中断。这意味着:
- 您之前收到的赔率可能不再反映博彩商的当前价格
- 在连接恢复之前,无法保证进一步的更新
- 您应该立即暂停该博彩商的任何自动化投注或套利逻辑
- 将该博彩商的所有现有赔率视为未验证,直到
staleOdds 恢复为 false
staleOddsResponseCode 已弃用。该字段曾提供触发过期检测的 HTTP 状态码(如有)— 请勿在新逻辑中依赖它,改用 staleOdds。
participantsRotated — 主客场映射
当 participantsRotated = true 时,该博彩商将不同的队伍视为主队,与 OddsPapi 的基准不同。换句话说,participant1(主队)和 participant2(客队)在该博彩商处与 OddsPapi 基准赛事相比是互换的。
这对以下方面至关重要:
- 独赢 / 1x2 盘口 — “主队”和”客队”结果含义相反
- 让分 / 让球盘 — 让分的正负号翻转
- 任何自动化策略 — 按参赛方位置而非参赛方 ID 映射结果
如果您在 OddsPapi 之上构建系统,请始终检查此标志,并在其为 true 时交换该博彩商的参赛方映射。
- 如果博彩商不在
bookmakers 中,假设该赛事当前没有可用赔率。
- 将此频道用作处理
odds 频道赔率之前的预过滤器。
- 结合
staleOdds、suspended 和 hasOdds 来判断博彩商的赔率在任何给定时刻是否可信。