跳转到主要内容
把参考价格订阅迁移到 PolyBolt,同时保留应用中按事件处理价格的流程。参考价格需要认证。
每个 PolyBolt 价格订阅都必须指定数据提供方, 且由 Chainlink 提供的订阅需要你自己的 Chainlink API 密钥。见发送你的 Chainlink API 密钥。

迁移 API 集成

更新连接、认证和订阅帧。完整协议见实时数据频道。

变化点

主题映射

加密货币现货和 TWAP 订阅现在使用以 usd 结尾的小写符号,不再使用 usdt。请将 btcusdt 或 btc/usd 改为 btcusd,并对所有订阅的加密货币符号使用相同格式。
实时价格负载包含 symbol、value、full_accuracy_value、timestamp 和标识价格提供商的 source。在每个过滤条件中通过 provider 指定价格提供商(指定价格数据提供方)。股票类更新还可能包含 received_at 和 is_carried_forward。TWAP 使用 window_seconds。请优先使用精确小数 full_accuracy_value,而非浮点 value。旧版 TWAP 帧使用 window_s 和 E18 定点价格,不要对 PolyBolt 的小数字符串再进行 E18 换算。

迁移前后

RTDS
PolyBolt

客户端清单

  1. 指向 wss://ws-live-v2.polymarket.com/ws,删除 PING 文本心跳。
  2. 订阅价格频道前先发送带 CLOB API 凭据的 {"op":"auth", ...}。
  3. 在每个连接上批量发送订阅,活跃订阅不超过 64 个。
  4. 使用快照初始化本地状态,再应用实时更新。只在同一连接的同一频道内比较 seq。
  5. 4003 做一次带抖动的重连,4008 视为 bug,每次重连后重新订阅。

评论数据流停用

实时评论数据流即将停用,且不会提供替代的流式频道。支持的评论列表查询方式见评论。

RTDS 活动数据流

activity 主题继续使用 RTDS,目前没有对应的 PolyBolt 频道。

将 SDK 迁移到 PolyBolt

迁移 60 秒 TWAP 订阅

@polymarket/client 从 0.11.0 版本开始支持 PolyBolt。 通过 createSecureClient 迁移 BTC/USD 的 60 秒 TWAP 订阅。已弃用的 RTDS 价格主题计划在 0.11.0 发布一个月后移除。
1

创建已认证客户端

设置 POLYMARKET_PRIVATE_KEY。本例使用签名者的 EOA 地址,默认连接生产环境。
2

订阅价格

将主题从 prices.crypto.chainlink.twap 改为 prices.crypto.twap,显式提供 symbols 列表,并设置 provider: PriceProvider.Chainlink。将 btc/usd 改为 btcusd,并从订阅输入中移除 windowSeconds。新主题固定使用 60 秒窗口。
events: CryptoTwapPriceEvent[]
返回事件仍包含 windowSeconds: 60。旧版 30 秒 TWAP 工作流没有 PolyBolt 替代方案。subscribe() 等待服务端接受订阅。快照事件的 payload.data 用于初始化历史。更新事件保留 symbol、timestamp、小数字符串 value 和 windowSeconds。
新的加密货币主题要求显式提供 btcusd 等小写 USD 符号。btc/usd、btcusdt 和 BTCUSD 会触发 UserInputError,SDK 不会自动改写这些输入。

迁移加密货币现货价格

使用上方创建的已认证 client。将符号后缀从 usdt 改为 usd,例如将 btcusdt 改为 btcusd。移除斜杠分隔符,例如将 btc/usd 改为 btcusd。新主题要求显式提供小写 USD 符号。设置 provider: PriceProvider.Binance 以请求 Binance 价格,或设置 PriceProvider.Chainlink 以保留旧版 Chainlink 现货主题的数据源。必须提供 provider。通过 event.payload.source 确认实际提供的数据源。
替换为以下订阅:
events: CryptoPriceEvent[]

迁移股票价格

使用上方创建的已认证 client。更改主题时保留 symbol 和 types。
替换为以下订阅:
events: EquityPriceEvent[]
types: ["update"] 仅接收实时更新。省略 types 即可同时接收历史快照。