Skip to main content
PolyBolt 通过一个连接推送加密货币、股票类资产和 TWAP 参考价格。订阅需要 CLOB API 凭据。 如果你目前使用 RTDS，请阅读从 RTDS 迁移。

​
连接

建立 WebSocket 连接：
选择频道，完成认证，然后发送订阅请求。

​
频道

符号使用小写。

​
为需授权频道认证

订阅参考价格前，在已建立的连接上发送你的 CLOB API 凭据：
等待服务端确认认证成功：
服务端通过错误确认报告认证问题，例如：
以下错误不会关闭连接：

​
订阅

发送要订阅的频道和过滤条件。以下请求在已认证的连接上订阅 BTC 参考价格：
一个批量帧只计一次速率限制。

​
信封

数据信封承载快照和实时更新。确认帧报告请求的处理结果。
请求包含 rid 时，确认帧会原样返回该值。 每个新订阅都会收到确认和一帧快照。使用快照初始化本地状态，再应用最新价格。快照包含前两分钟的数据，没有近期数据时 data 数组为空。重复订阅已有的频道和过滤条件会再次收到确认，但不会收到新快照。 数据信封中的字段：
  • seq 按连接、按频道连续，快照也占用序号。重连后序号重置。
  • ts 是生产方的事件时间，单位为 Unix 毫秒。
  • snapshot: true 标识初始快照。
  • 可选字段 dropped 表示自上一帧送达后，该频道因客户端落后而丢弃的帧数。
只在同一连接的同一频道内比较序号。每种消息的完整结构见实时数据频道。机器可读的契约位于 https://ws-live-v2.polymarket.com/asyncapi.json。

​
取消订阅

使用相同的频道和过滤条件，并将 op 设为 "unsubscribe"：
服务端通过 unsubscribed 确认取消订阅。subscribe 和 unsubscribe 都支持单个 channel 与 filter，或 subscriptions 数组。

​
支持的符号

​
加密货币价格

price.crypto.twap 使用 window_seconds: 60。其他窗口不提供数据。

​
股票类资产价格

price.equity 支持以下小写符号：

​
限制与存活检测

服务端每 25 秒发送一次 WebSocket ping，标准客户端会自动回应。连续两次未收到 pong 时，连接以 4002 关闭。 也可以发送 { "op": "ping" } 在应用层检查连接。服务端回复 pong。

​
关闭码与重连

根据关闭码选择重试方式： 如果连接请求被以 HTTP 429 或 503 拒绝，将 Retry-After 视为最短等待时间并添加随机延迟。浏览器客户端看到的握手失败表现为 1006，应使用指数退避和完全随机抖动。 重连后，为需授权频道重新认证并重新发送订阅。使用新快照初始化应用，序号从头开始。