Polymarket이 RTDS를 대체했습니다: PolyBolt로 마이그레이션하기

봇이 무언가를 결정하기 위해 현물 가격을 스트리밍한다면(암호화폐 Up/Down 마켓에서는 대부분 그렇습니다) 이 변경의 영향을 받습니다. 여섯 가지가 한꺼번에 바뀌었고, 곤란한 점은 그중 여러 개가 조용히 실패한다는 것입니다. 연결은 유지되지만, 받고 있다고 생각하는 가격을 더 이상 받지 못합니다.

여섯 가지 호환성 변경

채널 대응표

연결하기

연결을 연 뒤 먼저 인증하고, 확인을 기다린 다음 구독하세요. 기준 가격 채널은 인증되지 않은 구독을 거부합니다.

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

이 자격 증명은 CLOB 거래를 위해 파생하는 것과 같으며, 키, 시크릿, 패스프레이즈를 함께 사용합니다. 만든 적이 없다면 엔드포인트 가이드에서 L1/L2 흐름을 다룹니다.

RTDS에는 없던 PolyBolt의 세 가지

• 구독할 때마다 스냅샷 제공. 각 구독은 직전 2분간의 가격을 snapshot: true와 함께 반환하며, 비어 있을 수도 있습니다. 이것으로 로컬 상태를 초기화한 뒤 실시간 업데이트를 적용하세요. RTDS에서는 거래가 뜸한 심볼이면 그냥 아무 응답이 없어서, 연결되어 있는 건지 틱 사이에 있는 건지 알 수 없었습니다.
• 빈틈없는 seq와 dropped 카운터. 드디어 누락을 감지할 수 있습니다. RTDS에는 시퀀스가 전혀 없어서 놓친 메시지가 보이지 않았습니다. 채널별로 seq를 추적하고 건너뛰는 값이 있으면 재동기화 신호로 취급하세요.
• 원시 1006 대신 유형별 종료 코드: 4001 인증, 4002 느린 소비자, 4003 서버 드레이닝, 4008 정책 위반. 4002는 여러분이 소켓을 비우는 속도가 너무 느리다는 뜻입니다. 네트워크 문제가 아니라 소비자 버그이며, 재연결로는 고쳐지지 않습니다.

연결 한도

RTDS는 한도를 공개하지 않았습니다. PolyBolt는 공개하며, 어느 하나라도 넘으면 4008로 소켓이 닫힙니다:

계획할 때 고려해야 할 것은 64개 구독 한도입니다. BTC, ETH, SOL을 현물과 TWAP으로 추적하면 6개이므로 암호화폐 봇에는 여유가 충분하지만, 주식 목록 전체로 확장하는 시스템은 한도에 걸릴 것입니다.

봇 마이그레이션 순서

1. CLOB API 자격 증명이 없다면 파생하세요. RTDS는 공개였지만 PolyBolt는 그렇지 않습니다. 다른 모든 단계를 막는 단계입니다.
2. URL을 wss://ws-live-v2.polymarket.com/ws로 바꾸세요.
3. 클라이언트 하트비트를 삭제하세요. 5초 PING 루프는 불필요할 뿐 아니라 이제 잡음입니다. 서버가 25초마다 ping을 보냅니다.
4. 구독 프레임을 다시 작성하세요. action → op, topic → channel, 그리고 filter는 문자열이 아니라 JSON 객체가 됩니다.
5. 모든 심볼을 고치세요: btcusdt와 btc/usd는 모두 btcusd가 됩니다. 소문자, USD.
6. 스냅샷 프레임을 처리해 2분치 백필을 실시간 틱으로 착각하지 않도록 하세요.
7. seq 누락 감지를 추가하고 건너뛰면 재동기화하세요.
8. Binance 가격에 맞춰 튜닝한 모든 것을 다시 보정하세요. 이제 소스는 Pyth입니다.

바뀌지 않는 것

과도하게 마이그레이션하기 쉬우므로 정확히 짚어 두겠습니다. CLOB market 및 user 채널은 바뀌지 않았습니다. wss://ws-subscriptions-clob.polymarket.com/ws/market은 여전히 오더북과 가격 업데이트를 전달하고, 여전히 10초마다 클라이언트 PING을 요구하며, 여전히 best_bid_ask, new_market, market_resolved를 custom_feature_enabled 뒤에 숨겨 둡니다. 옮겨진 것은 기준 가격뿐입니다. 자세한 내용은 WebSocket 가이드에 있습니다.

더 근본적인 한계도 그대로입니다. 스트림은 연결한 순간부터의 가격만 줍니다. 지난 화요일의 오더북 모습은 알려줄 수 없습니다. Polymarket은 결과가 확정된 마켓의 오더북에 대해 404를 반환하고 가격 기록은 약 1분에 한 포인트만 보관하므로, 백테스팅에는 마켓이 진행되는 동안 기록된 아카이브가 필요합니다. Up/Down 마켓의 작동 방식을 보거나 마켓 조회에서 특정 마켓을 찾아보세요.