Polytoolhub
What is Polymarket Sports WebSocket?
The sports WebSocket supplies the live sporting context around Polymarket contracts: whether a game has started, its score, current period and end state. Join it to Gamma’s game and event metadata to keep a sports market page current without treating an outcome-token price as a game score.
Who it is for
- Developers building live sports market pages
- Applications monitoring game state alongside positions
- Sports dashboards that already use Gamma metadata
Features and coverage
- Available on
- WebSocket
- Markets & venues
- Polymarket
- Research topics
- Sports
- Public connection
Connect to wss://sports-api.polymarket.com/ws without authentication.
- Game status
Receive live and ended state changes.
- Scores and periods
Update the scoreboard and competition-specific period display.
- Possession events
NFL and college-football updates include possession changes.
- Game identity
Associate the feed with game-linked market discovery.
- Heartbeat protocol
Answer the server’s Ping messages to keep the connection alive.
Workflows with Polymarket Sports WebSocket
Build a live game panel
Resolve the game through Gamma, join its feed updates and render score, period and status beside the related contracts.
Refresh after a disconnect
Reconnect, reconcile the game’s current state and resume processing. Keep stale connection status separate from whether the game has ended.
Pricing and total cost
The sports feed is public and requires no API credentials. The reference does not list a subscription charge.
Getting started
Before you start: Period and status values differ by sport, including halves, quarters, innings and esports maps.
- Resolve the relevant game and market identifiers through Gamma.
- Open the public sports WebSocket.
- Parse sport-specific score, period and status values.
- Answer Ping with Pong within 10 seconds; the server sends Ping every 5 seconds.
- Reconnect and reconcile current state when the socket closes.
Useful links
What to check
- Period and status values differ by sport, including halves, quarters, innings and esports maps.
- Status values are case-sensitive.
- This feed carries game state rather than the CLOB order book.
- A game can have several companion markets and props.
A closer look
Ratings & reviews
User reviews 0
The main score switches to user ratings after 5 published reviews.
A specific example helps the next person choose the right tool.
Write a review
How was your experience with Polymarket Sports WebSocket?
Share what you used, what worked and what could be better. We confirm your email and review the submission before publishing.
To submit a review, email info@polytradingbot.com with the tool name, your rating and your experience. Enable JavaScript to prepare a draft here.
Related tools
Browse category
The official TypeScript SDK for public market data, typed pagination, real-time subscriptions and authenticated trading and wallet actions.
- Language TypeScript · JavaScript
Read Polymarket prices and order books or build authenticated order placement, cancellation and account-order management.
- Data coverage Prices · Order books
- Access API
Discover Polymarket events, markets, tags, series and sports metadata before querying prices or building a market catalog.
- Data coverage Markets · Events
- Access API
Frequently asked questions about Polymarket Sports WebSocket
Do I need a wallet or API key?
No. This is a public feed.
Does it include live order-book prices?
Use the CLOB market-data channel for outcome-token books and prices.
Can I use one period parser for every sport?
Normalize separately for each sport; a quarter, inning and map are different states.