Dynamic odds API on a Pinnacle WebSocket
Answer: dynamic odds are prices that change as the market trades. PinnFeed delivers them as a snapshot, then deltas on wss://pinnfeed.io/v1/stream (Builder €99/mo). After subscribe, wait until a snapshot part arrives with final: true, then apply each delta upsert or remove. Free and Hobby keys get 403 plan_lacks_ws — they can still poll /v1/odds. This is a definition and a how-to, not a latency contest.
How the stream carries a moving book#
- Connect to
/v1/streamwithx-api-key: ps_live_...(or?key=). - Subscribe to the sports or events you need.
- Rebuild from
snapshotparts (clear local maps whenpart === 1). - Apply
deltaupserts and removes as prices move. - Reply
{"type":"pong"}to pings.
// Builder WebSocket — educational sketch, not a benchmark
if (msg.type === "snapshot" && msg.part === 1) { events.clear(); markets.clear(); }
Protocol: snapshot vs delta, WebSocket docs, integration guide.
A polling client only sees a change on its next request, so on average it is half a polling interval late, plus the request round-trip. That is arithmetic, not a measured delay versus any named vendor. We do not publish or invent competitor latencies.
Plans#
Dynamic (pushed) odds need Builder (€99/mo, or €990/yr ≈ €82.50/mo) or Pro. Hobby (€29/mo) is real-time REST only. Free is delayed REST. Each market also carries fair, margin and maxStake (a floor around 100 is a common thin-line filter).
Try it#
Start a 3-day Builder trial (€99/mo, VAT incl. where applicable) or get a free delayed REST key to inspect snapshots. Paid plans: 3-day trial; a card is required and it is charged after day 3 unless you cancel.
Educational content for adults (18+). No tips, no guaranteed profit.
Questions people ask#
Is a REST poller “dynamic odds”?#
You can poll /v1/odds and see new prices on each request. “Dynamic” in the live sense is the WebSocket: the server pushes each change. Polling stays half an interval behind on average.
Which plan?#
The stream is Builder (€99/mo) or Pro. See prematch vs live + prematch.
Do you claim lower latency than other vendors?#
No. Measure it yourself on your path: latency honesty.