Polymarket заменил RTDS: миграция на PolyBolt

Если ваш бот получает поток спот-цен, чтобы принимать какие-либо решения, — а на крипторынках Up/Down так делает большинство, — это касается вас. Одновременно изменились шесть вещей, и неприятно то, что некоторые из них ломаются тихо: вы остаётесь подключены, просто перестаёте получать те цены, которые, как вам кажется, получаете.

Шесть несовместимых изменений

Соответствие каналов

Подключение

Сначала пройдите аутентификацию на открытом соединении, дождитесь подтверждения, затем подписывайтесь. Каналы референсных цен отклоняют подписки без аутентификации.

{
  "op": "auth",
  "rid": "a1",
  "auth": {
    "apiKey": "<api key>",
    "secret": "<api secret>",
    "passphrase": "<api passphrase>"
  }
}

Это те же учётные данные, которые вы получаете для торговли в CLOB, — ключ, секрет и passphrase вместе. Если вы их ещё не создавали, процесс L1/L2 описан в руководстве по эндпоинтам.

Три вещи, которые PolyBolt даёт, а RTDS не давал

• Снимок при каждой подписке. Каждая подписка возвращает цены за предыдущие две минуты с snapshot: true (возможно, пустые). Инициализируйте локальное состояние по нему, затем применяйте живые обновления. В RTDS по тихому символу вы получали просто тишину и не знали, подключены ли вы или просто между тиками.
• Плотный seq и счётчик dropped. Наконец можно обнаруживать пропуски. В RTDS последовательности не было вовсе, так что пропущенное сообщение было невидимо. Отслеживайте seq для каждого канала и считайте любой скачок поводом для ресинхронизации.
• Типизированные коды закрытия вместо сырого 1006: 4001 — аутентификация, 4002 — медленный потребитель, 4003 — сервер освобождается, 4008 — нарушение политики. 4002 означает, что вы слишком медленно вычитываете сокет, — это ошибка потребителя, а не сети, и переподключение её не исправит.

Лимиты соединения

RTDS их не публиковал. PolyBolt публикует, и нарушение любого из них закрывает сокет с кодом 4008:

Планировать стоит вокруг 64 подписок. Если вы отслеживаете BTC, ETH и SOL по споту и TWAP, это шесть, так что для криптобота запаса много, — но система, которая разворачивается на весь каталог акций, в него упрётся.

Миграция бота по шагам

1. Получите учётные данные CLOB API, если у вас их нет. RTDS был публичным, PolyBolt — нет. Этот шаг блокирует всё остальное.
2. Смените URL на wss://ws-live-v2.polymarket.com/ws.
3. Удалите клиентский heartbeat. Цикл PING каждые 5 секунд не просто не нужен — теперь это шум. Сервер пингует вас каждые 25 секунд.
4. Перепишите кадры подписки — action → op, topic → channel, а filter становится JSON-объектом, а не строкой.
5. Исправьте все символы: btcusdt и btc/usd оба становятся btcusd. Нижний регистр, USD.
6. Обрабатывайте кадр снимка, чтобы не принять две минуты исторических данных за живые тики.
7. Добавьте обнаружение пропусков по seq и ресинхронизацию при скачке.
8. Перекалибруйте всё, что настроено на цены Binance. Теперь источник — Pyth.

Что это не меняет

Стоит быть точным, потому что легко мигрировать лишнее. Рыночный и пользовательский каналы CLOB не затронуты. wss://ws-subscriptions-clob.polymarket.com/ws/market по-прежнему передаёт обновления стакана и цен, по-прежнему требует клиентский PING каждые 10 секунд и по-прежнему скрывает best_bid_ask, new_market и market_resolved за custom_feature_enabled. Переехали только референсные цены. Подробности — в руководстве по WebSocket.

И более глубокое ограничение тоже не изменилось: поток даёт цены с момента подключения. Он не скажет, как выглядел стакан в прошлый вторник. Polymarket возвращает 404 для стакана разрешившегося рынка и хранит историю цен лишь примерно с одной точкой в минуту — поэтому для бэктестинга нужен архив, записанный, пока рынки работали. См. как устроены рынки Up/Down или найдите конкретный рынок через поиск рынка.