Log inSign up
WebSocketPolitics & Elections

Polymarket CLOB WebSocket (ws-subscriptions-clob)

Polymarket CLOB WebSocket (ws-subscriptions-clob) is a websocket from Polymarket providing politics & elections data. Polymarket's native CLOB WebSocket pushes real-time order-book and price updates for every market on the venue, including its election and political markets. A Polymarket bot subscribes to the market channel to receive live book snapshots and price deltas for the exact contracts it trades, and the authenticated user channel to track its own order and trade lifecycle.

At a glance

ProviderPolymarket
TypeWebSocket
CategoryPolitics & Elections
Real-timeYes — streaming
AuthAPI key
PricingFree (no API/WebSocket fee; only on-chain taker trading fees apply, and politics/world-events markets are fee-free) — Market data & WebSocket access: free, no API key, no subscription, Maker orders: zero trading fees, Taker fees: per-category rate (~0.03-0.07) applied at match time, geopolitical/politics & world-events markets fee-free, No deposit/withdrawal fees on USDC

What data it provides

  • Full order-book snapshots (book) keyed by asset/token ID
  • Incremental price-level deltas (price_change) for bids and asks
  • Last trade price (last_trade_price) on executions
  • Tick-size changes (tick_size_change) per market
  • User channel: own order lifecycle events (order) and trade status updates (trade)
  • Optional best_bid_ask, new_market, market_resolved events (custom_feature_enabled)

Features

  • Endpoint wss://ws-subscriptions-clob.polymarket.com/ws/ with separate /market (public) and /user (authenticated) channels
  • Market channel requires no auth; user channel needs apiKey, secret, passphrase L2 credentials
  • Real-time push; subscribe by asset_ids (token IDs) to scope to specific markets/outcomes
  • Requires PING every ~10s to keep the connection alive (server replies PONG)
  • Official SDKs: py-clob-client (Python) and clob-client (TypeScript)
  • Covers all Polymarket markets including election/politics contracts on the same feed

Links

Use it in a bot

Other politics & elections data sources

Listed, not endorsed. Pricing and capabilities change without notice — check the provider's own documentation before you depend on anything here. Browse the full data resources directory or the strategy database.
Join Discord