Skip to main content
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"
}
FieldTypeDescription
topicstringThe subscription topic (e.g., crypto_prices, equity_prices, comments)
typestringThe message type/event (e.g., update, reaction_created)
timestampnumberUnix timestamp in milliseconds when the message was sent
payloadobjectEvent-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
  }
}
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

FieldTypeDescription
symbolstringTrading pair symbol. Binance: lowercase concatenated (e.g., solusdt, btcusdt). Chainlink: slash-separated (e.g., eth/usd, btc/usd)
timestampnumberWhen the price was recorded, in Unix milliseconds
valuenumberCurrent 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

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.

​
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

FieldTypeDescription
symbolstringLowercase symbol identifier (e.g., aapl, eurusd, xauusd)
valuenumberSpot price as a float
full_accuracy_valuestringFull-precision price as a string
timestampnumberPrice measurement timestamp in Unix milliseconds
received_atnumberWhen the system received the price, in Unix milliseconds. Only present when non-zero.
is_carried_forwardbooleantrue when the market session is closed and the value is the last known price. Only present when true.

​
Supported Symbols

Stocks:
SymbolName
AAPLApple
TSLATesla
MSFTMicrosoft
GOOGLAlphabet
AMZNAmazon
METAMeta Platforms
NVDANVIDIA
NFLXNetflix
PLTRPalantir
OPENOpendoor
RKLBRocket Lab
ABNBAirbnb
COINCoinbase
HOODRobinhood
ETFs:
SymbolName
QQQInvesco QQQ ETF
SPYS&P 500 ETF
EWYiShares MSCI South Korea ETF
VXXBarclays iPath Series B S&P 500 VIX
Forex:
SymbolPair
EURUSDEuro / US Dollar
GBPUSDBritish Pound / US Dollar
USDCADUS Dollar / Canadian Dollar
USDJPYUS Dollar / Japanese Yen
USDKRWUS Dollar / South Korean Won
Precious Metals:
SymbolName
XAUUSDGold
XAGUSDSilver
Commodities (rolling front-month futures):
SymbolName
WTICrude Oil (WTI)
CCCocoa
NGDNatural 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.

​
Subscribe

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

​
Message Types

TypeDescription
comment_createdA user creates a new comment or reply
comment_removedA comment is removed or deleted
reaction_createdA user adds a reaction to a comment
reaction_removedA 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

FieldTypeDescription
bodystringThe text content of the comment
createdAtstringISO 8601 timestamp when the comment was created
idstringUnique identifier for this comment
parentCommentIDstringID of the parent comment if this is a reply (null for top-level comments)
parentEntityIDnumberID of the parent entity (event, market, etc.)
parentEntityTypestringType of parent entity (Event, Market)
profileobjectProfile information of the comment author
reactionCountnumberCurrent number of reactions on this comment
replyAddressstringPolygon address for replies (may differ from userAddress)
reportCountnumberCurrent number of reports on this comment
userAddressstringPolygon address of the comment author

​
Profile Object Fields

FieldTypeDescription
baseAddressstringUser profile address
displayUsernamePublicbooleanWhether the username is displayed publicly
namestringUser’s display name
proxyWalletstringProxy wallet address used for transactions
pseudonymstringGenerated 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

Send PING messages every 5 seconds to keep the connection alive. Connection errors will trigger automatic reconnection attempts.
Verify your subscription message is valid JSON with the correct action, topic, and type fields. Invalid subscription messages may result in connection closure.
If subscribing to user-specific streams, ensure your gamma_auth object includes a valid wallet address. Authentication failures will prevent subscription to protected topics.