Overview

The Polymarket CLOB API provides websocket (wss) channels through which clients can get pushed updates. These endpoints allow clients to maintain almost real-time views of their orders, their trades and markets in general. There are two available channels user and market.

Subscription

To subscribe send a message including the following authentication and intent information upon opening the connection.

FieldTypeDescription
authAuthsee next page for auth information
marketsstring[]array of markets (condition IDs) to receive events for (for user channel)
assets_idsstring[]array of asset ids (token IDs) to receive events for (for market channel)
typestringid of channel to subscribe to (USER or MARKET)

Where the auth field is of type Auth which has the form described in the WSS Authentication section below.