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

频道

OddsPapi WebSocket 频道文档对它们作了整体说明。

先加载,再应用变化

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

连接并登录

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

加载状态

从 /v1/{lang} 读取赛事及其赔率,例如 GET /v1/en/fixtures/odds。
3

应用变化

在已加载的状态之上,先应用您保留的消息,再应用之后的每条新消息。
先连接后加载,就不会在两者之间丢失任何变化。已经包含在加载状态中的变化,再应用一次也无妨。

收到 snapshot_required 时重新加载

当 Apexium 无法保证您收到了每一个变化时,它会告诉您需要重新加载哪些频道:
请从 /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。参见语言。
赔率占行情数据的大部分,因此您需要逐场赛事关注赔率,并受账户赛事限制的约束。要交易整个联赛:
  1. 在 fixtures 上用该联赛的 tournamentIds 登录,或从 /v1/{lang} 读取其赛事。
  2. 发送 { "type": "subscribe", "fixtureIds": [...] },带上您要交易的赛事,它们的赔率随即开始推送。
  3. 赛事结束后,为其发送 unsubscribe,以释放名额。

读取过慢会被关闭

Apexium 向每个客户端发送其能承受的数据量。发送缓冲区持续满载的连接会以 4002 关闭,其他客户端不会因此变慢。参见关闭代码。 要跟上数据流:
  • 使用 zstd。 它可将数据流缩小约四倍。参见编码。
  • 在独立任务中读取。 快速解码并保存每条消息;把定价或数据库写入等耗时工作放到其他地方。
  • 只关注您用到的内容。 fixtureIds 中的每场赛事都会把它的赔率加入您的数据流。