Skip to main content
Use Polymarket’s real-time feeds to react as market conditions and related data change. They keep the public market data your application depends on current without repeated polling. For authenticated order and trade updates, see Real-Time Order Updates.

Market Stream

Use the market stream to keep your application in sync with changes to a market’s order book and trading state.
Given a PublicClient or SecureClient, subscribe to the market topic with one or more token IDs:

Order Book

Price Change

Last Trade Price

Tick Size Change

Enable customFeatureEnabled to include top-of-book and market lifecycle updates:

Best Bid and Ask

New Market

Market Resolved

Sports Stream

Use the sports stream to keep live game information current alongside sports markets. Updates arrive when a game goes live, its score or period changes, or it ends. NFL and CFB updates can also reflect possession changes.
Sports data is provided for informational purposes only. It may be delayed, contain errors, or omit recent events. Polymarket does not provide trading or investment advice, and this data should not be used as the basis for a trading decision.
Given a PublicClient or SecureClient, subscribe to the sports topic to receive every game update:
score is a combined "<home>-<away>" string, not separate home and away fields.

Period Values

The meaning and format of a period depend on the sport:

Game Status Values

Status values vary by sport and are case-sensitive:

RTDS Streams

The Real-Time Data Service (RTDS) carries reference prices and comments over a shared real-time connection. Subscribe only to the topics your application needs.

Crypto Prices

Use crypto price streams to keep reference values current alongside related markets.
Trading 15-minute crypto markets? Request a sponsored Chainlink API key with onboarding support from Chainlink.
Use the symbol format for the selected price source:
Given a PublicClient or SecureClient, subscribe to the crypto price topics you need:

Binance Price Update

Equity Prices

Equity price streams provide Pyth Network reference prices for stocks, ETFs, forex pairs, precious metals, and commodities.
Trading equity markets? Subscribe to a Pyth Network data feed. The first 30 days are free, then access costs $99 per month.

Subscribe to Equity Prices

Given a PublicClient or SecureClient, subscribe to the equity price topic for the symbols you need:

Equity Price Update

Equity Price Snapshot

Historical Snapshot

When you subscribe to a symbol, the stream first sends its preceding two minutes of price data and then continues with live updates. Use this snapshot to initialize your local state before processing new prices.

Supported Symbols

Subscription symbols are case-insensitive, but stream events return symbols in lowercase.

Market Hours

When the market for an asset is closed, the stream continues with its last known price and marks that value as carried forward. During market hours, prices can update up to five times per second for each feed.

Comments

Use the comments stream to keep conversations and reactions current wherever your application displays Polymarket discussion. Comments can begin a thread or reply to another comment; reply events include the parent comment’s ID.
Given a PublicClient or SecureClient, subscribe to the comments topic and select the event types you need:
Use parentEntityId and parentEntityType to scope the subscription to one event or market.

New Comment

Removed Comment

New Reaction

Removed Reaction