Real-Time Data Socket

The Polymarket Real-Time Data Socket (RTDS) is a WebSocket-based streaming service that provides real-time updates for comments, crypto prices, and equity prices.

TypeScript client

Official RTDS TypeScript client (real-time-data-client).

Endpoint

wss://ws-live-data.polymarket.com

Some user-specific streams may require gamma_auth with your wallet address.

Subscribing

Send a JSON message to subscribe to data streams:

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "topic_name",
      "type": "message_type",
      "filters": "optional_filter_string",
      "gamma_auth": {
        "address": "wallet_address"
      }
    }
  ]
}

To unsubscribe, send the same structure with "action": "unsubscribe". Subscriptions can be added, removed, and modified without disconnecting. Send PING messages every 5 seconds to maintain the connection.

Only the subscription types documented below are supported.

Message Structure

All messages follow this structure:

{
  "topic": "string",
  "type": "string",
  "timestamp": "number",
  "payload": "object"
}

Field	Type	Description
`topic`	string	The subscription topic (e.g., `crypto_prices`, `equity_prices`, `comments`)
`type`	string	The message type/event (e.g., `update`, `reaction_created`)
`timestamp`	number	Unix timestamp in milliseconds when the message was sent
`payload`	object	Event-specific data object

Crypto Prices

Real-time cryptocurrency price data from two sources: Binance and Chainlink. No authentication required.

Binance Source

Subscribe to all symbols:

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "crypto_prices",
      "type": "update"
    }
  ]
}

Subscribe to specific symbols with a comma-separated filter:

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "crypto_prices",
      "type": "update",
      "filters": "solusdt,btcusdt,ethusdt"
    }
  ]
}

Symbols use lowercase concatenated format (e.g., solusdt, btcusdt). Solana price update:

{
  "topic": "crypto_prices",
  "type": "update",
  "timestamp": 1753314064237,
  "payload": {
    "symbol": "solusdt",
    "timestamp": 1753314064213,
    "value": 189.55
  }
}

Bitcoin price update:

{
  "topic": "crypto_prices",
  "type": "update",
  "timestamp": 1753314088421,
  "payload": {
    "symbol": "btcusdt",
    "timestamp": 1753314088395,
    "value": 67234.50
  }
}

Chainlink Source

Trading 15m Crypto Markets? Get a sponsored Chainlink API key with onboarding support from Chainlink. Fill out this form.

Subscribe to all symbols:

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "crypto_prices_chainlink",
      "type": "*",
      "filters": ""
    }
  ]
}

Subscribe to a specific symbol with a JSON filter:

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "crypto_prices_chainlink",
      "type": "*",
      "filters": "{\"symbol\":\"eth/usd\"}"
    }
  ]
}

Symbols use slash-separated format (e.g., eth/usd, btc/usd). Ethereum price update:

{
  "topic": "crypto_prices_chainlink",
  "type": "update",
  "timestamp": 1753314064237,
  "payload": {
    "symbol": "eth/usd",
    "timestamp": 1753314064213,
    "value": 3456.78
  }
}

Bitcoin price update:

{
  "topic": "crypto_prices_chainlink",
  "type": "update",
  "timestamp": 1753314088421,
  "payload": {
    "symbol": "btc/usd",
    "timestamp": 1753314088395,
    "value": 67234.50
  }
}

Price Payload Fields

Field	Type	Description
`symbol`	string	Trading pair symbol. Binance: lowercase concatenated (e.g., `solusdt`, `btcusdt`). Chainlink: slash-separated (e.g., `eth/usd`, `btc/usd`)
`timestamp`	number	When the price was recorded, in Unix milliseconds
`value`	number	Current price value in the quote currency

Supported Symbols

Binance Source — lowercase concatenated format:

btcusdt — Bitcoin to USDT
ethusdt — Ethereum to USDT
solusdt — Solana to USDT
xrpusdt — XRP to USDT

Chainlink Source — slash-separated format:

btc/usd — Bitcoin to USD
eth/usd — Ethereum to USD
sol/usd — Solana to USD
xrp/usd — XRP to USD

Equity Prices

Real-time price data for stocks, ETFs, forex pairs, precious metals, and commodities sourced from Pyth Network. No authentication required.

Trading Equity Markets? Get a Pyth Network data feed - first 30 days free, then $99/month. Subscribe here.

All asset classes stream through a single equity_prices topic. When you subscribe with a symbol filter, the server sends a historical snapshot (last 2 minutes of data), then continues streaming live updates. Subscribe to a specific symbol with a JSON filter:

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "equity_prices",
      "type": "update",
      "filters": "{\"symbol\":\"AAPL\"}"
    }
  ]
}

Subscribe to multiple symbols across asset classes:

{
  "action": "subscribe",
  "subscriptions": [
    { "topic": "equity_prices", "type": "update", "filters": "{\"symbol\":\"AAPL\"}" },
    { "topic": "equity_prices", "type": "update", "filters": "{\"symbol\":\"EURUSD\"}" },
    { "topic": "equity_prices", "type": "update", "filters": "{\"symbol\":\"XAUUSD\"}" },
    { "topic": "equity_prices", "type": "update", "filters": "{\"symbol\":\"WTI\"}" }
  ]
}

Use type: "*" to receive all message types (live updates and snapshots):

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "equity_prices",
      "type": "*",
      "filters": "{\"symbol\":\"GOOGL\"}"
    }
  ]
}

Filter values are case-insensitive on subscribe, but the symbol field in payloads is always returned lowercase.

Need the price-to-beat value? Pass the market slug to the price-to-beat endpoint:GET https://polymarket.com/api/equity/price-to-beat/{slug}Example: https://polymarket.com/api/equity/price-to-beat/wti-up-or-down-on-april-7-2026

Live Price Update

Apple stock update:

{
  "topic": "equity_prices",
  "type": "update",
  "timestamp": 1711382400000,
  "payload": {
    "symbol": "aapl",
    "value": 198.45,
    "full_accuracy_value": "198.4523",
    "timestamp": 1711382400000,
    "received_at": 1711382400005
  }
}

Gold price update (market closed):

{
  "topic": "equity_prices",
  "type": "update",
  "timestamp": 1711400000000,
  "payload": {
    "symbol": "xauusd",
    "value": 2175.30,
    "full_accuracy_value": "2175.3012",
    "timestamp": 1711399000000,
    "received_at": 1711400000002,
    "is_carried_forward": true
  }
}

Historical Snapshot

On subscribe, the server delivers a backfill of the last 2 minutes of price data. Use the type field to distinguish: "subscribe" for the initial snapshot vs "update" for live ticks.

{
  "topic": "equity_prices",
  "type": "subscribe",
  "timestamp": 1711382400000,
  "payload": {
    "symbol": "aapl",
    "data": [
      { "timestamp": 1711382280000, "value": 198.30 },
      { "timestamp": 1711382281000, "value": 198.32 },
      { "timestamp": 1711382340000, "value": 198.41 }
    ]
  }
}

Equity Price Payload Fields

Field	Type	Description
`symbol`	string	Lowercase symbol identifier (e.g., `aapl`, `eurusd`, `xauusd`)
`value`	number	Spot price as a float
`full_accuracy_value`	string	Full-precision price as a string
`timestamp`	number	Price measurement timestamp in Unix milliseconds
`received_at`	number	When the system received the price, in Unix milliseconds. Only present when non-zero.
`is_carried_forward`	boolean	`true` when the market session is closed and the value is the last known price. Only present when `true`.

Supported Symbols

Stocks:

Symbol	Name
`AAPL`	Apple
`TSLA`	Tesla
`MSFT`	Microsoft
`GOOGL`	Alphabet
`AMZN`	Amazon
`META`	Meta Platforms
`NVDA`	NVIDIA
`NFLX`	Netflix
`PLTR`	Palantir
`OPEN`	Opendoor
`RKLB`	Rocket Lab
`ABNB`	Airbnb
`COIN`	Coinbase
`HOOD`	Robinhood

ETFs:

Symbol	Name
`QQQ`	Invesco QQQ ETF
`SPY`	S&P 500 ETF
`EWY`	iShares MSCI South Korea ETF
`VXX`	Barclays iPath Series B S&P 500 VIX

Forex:

Symbol	Pair
`EURUSD`	Euro / US Dollar
`GBPUSD`	British Pound / US Dollar
`USDCAD`	US Dollar / Canadian Dollar
`USDJPY`	US Dollar / Japanese Yen
`USDKRW`	US Dollar / South Korean Won

Precious Metals:

Symbol	Name
`XAUUSD`	Gold
`XAGUSD`	Silver

Commodities (rolling front-month futures):

Symbol	Name
`WTI`	Crude Oil (WTI)
`CC`	Cocoa
`NGD`	Natural Gas

Market Hours

When a market session is closed, the stream continues with the last known price and is_carried_forward: true. This lets you distinguish stale prices from live ticks. Update frequency is sub-second (up to 5 per second per feed) during market hours.

Comments

Real-time comment events on the Polymarket platform, including new comments, replies, reactions, and removals. May require Gamma authentication for user-specific data.

{
  "action": "subscribe",
  "subscriptions": [
    {
      "topic": "comments",
      "type": "comment_created"
    }
  ]
}

Message Types

Type	Description
`comment_created`	A user creates a new comment or reply
`comment_removed`	A comment is removed or deleted
`reaction_created`	A user adds a reaction to a comment
`reaction_removed`	A reaction is removed from a comment

comment_created

Emitted when a user posts a new comment or replies to an existing one.

{
  "topic": "comments",
  "type": "comment_created",
  "timestamp": 1753454975808,
  "payload": {
    "body": "That's a good point about the definition.",
    "createdAt": "2025-07-25T14:49:35.801298Z",
    "id": "1763355",
    "parentCommentID": "1763325",
    "parentEntityID": 18396,
    "parentEntityType": "Event",
    "profile": {
      "baseAddress": "0xce533188d53a16ed580fd5121dedf166d3482677",
      "displayUsernamePublic": true,
      "name": "salted.caramel",
      "proxyWallet": "0x4ca749dcfa93c87e5ee23e2d21ff4422c7a4c1ee",
      "pseudonym": "Adored-Disparity"
    },
    "reactionCount": 0,
    "replyAddress": "0x0bda5d16f76cd1d3485bcc7a44bc6fa7db004cdd",
    "reportCount": 0,
    "userAddress": "0xce533188d53a16ed580fd5121dedf166d3482677"
  }
}

A reply to the above comment — note parentCommentID references the parent:

{
  "topic": "comments",
  "type": "comment_created",
  "timestamp": 1753454985123,
  "payload": {
    "body": "I agree, the resolution criteria should be clearer.",
    "createdAt": "2025-07-25T14:49:45.120000Z",
    "id": "1763356",
    "parentCommentID": "1763355",
    "parentEntityID": 18396,
    "parentEntityType": "Event",
    "profile": {
      "baseAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "displayUsernamePublic": true,
      "name": "trader",
      "proxyWallet": "0x9876543210fedcba9876543210fedcba98765432",
      "pseudonym": "Bright-Analysis"
    },
    "reactionCount": 0,
    "replyAddress": "0x0bda5d16f76cd1d3485bcc7a44bc6fa7db004cdd",
    "reportCount": 0,
    "userAddress": "0x1234567890abcdef1234567890abcdef12345678"
  }
}

Comment Payload Fields

Field	Type	Description
`body`	string	The text content of the comment
`createdAt`	string	ISO 8601 timestamp when the comment was created
`id`	string	Unique identifier for this comment
`parentCommentID`	string	ID of the parent comment if this is a reply (null for top-level comments)
`parentEntityID`	number	ID of the parent entity (event, market, etc.)
`parentEntityType`	string	Type of parent entity (`Event`, `Market`)
`profile`	object	Profile information of the comment author
`reactionCount`	number	Current number of reactions on this comment
`replyAddress`	string	Polygon address for replies (may differ from userAddress)
`reportCount`	number	Current number of reports on this comment
`userAddress`	string	Polygon address of the comment author

Profile Object Fields

Field	Type	Description
`baseAddress`	string	User profile address
`displayUsernamePublic`	boolean	Whether the username is displayed publicly
`name`	string	User’s display name
`proxyWallet`	string	Proxy wallet address used for transactions
`pseudonym`	string	Generated pseudonym for the user

Comment Hierarchy

Comments support nested threading:

Top-level comments: parentCommentID is null or empty
Reply comments: parentCommentID contains the ID of the parent comment
All comments are associated with a parentEntityID and parentEntityType (Event or Market)

Troubleshooting

Connection drops unexpectedly

Send PING messages every 5 seconds to keep the connection alive. Connection errors will trigger automatic reconnection attempts.

Not receiving messages after subscribing

Verify your subscription message is valid JSON with the correct action, topic, and type fields. Invalid subscription messages may result in connection closure.

Authentication failures

If subscribing to user-specific streams, ensure your gamma_auth object includes a valid wallet address. Authentication failures will prevent subscription to protected topics.

Getting Started

Core Concepts

Market Data

Trading

Market Makers

Builder Program

Resources

TypeScript client

Endpoint

Subscribing

Message Structure

Crypto Prices

Binance Source

Chainlink Source

Price Payload Fields

Supported Symbols

Equity Prices

Live Price Update

Historical Snapshot

Equity Price Payload Fields

Supported Symbols

Market Hours

Comments

Message Types

comment_created

Comment Payload Fields

Profile Object Fields

Comment Hierarchy

Troubleshooting

TypeScript client

​Endpoint

​Subscribing

​Message Structure

​Crypto Prices

​Binance Source

​Chainlink Source

​Price Payload Fields

​Supported Symbols

​Equity Prices

​Subscribe

​Live Price Update

​Historical Snapshot

​Equity Price Payload Fields

​Supported Symbols

​Market Hours

​Comments

​Subscribe

​Message Types

​comment_created

​Comment Payload Fields

​Profile Object Fields

​Comment Hierarchy

​Troubleshooting

Endpoint

Subscribing

Message Structure

Crypto Prices

Binance Source

Chainlink Source

Price Payload Fields

Supported Symbols

Equity Prices

Subscribe

Live Price Update

Historical Snapshot

Equity Price Payload Fields

Supported Symbols

Market Hours

Comments

Subscribe

Message Types

comment_created

Comment Payload Fields

Profile Object Fields

Comment Hierarchy

Troubleshooting