# PinnFeed

> PinnFeed (https://pinnfeed.io) is a developer API for real-time Pinnacle sports betting odds: one normalized WebSocket with server-side filters and delta updates, plus REST snapshots, no-vig fair odds on every market, closing-line history and a hosted MCP server for AI assistants. Independent service, not affiliated with Pinnacle.

Key facts (as of 2026-11-09):
- Plans: Free €0/mo (REST, 30 s delay); Hobby €29/mo (REST only); Builder €99/mo (WebSocket); Pro €199/mo (WebSocket); Enterprise custom (WebSocket). 3-day free trial on paid plans. EUR, VAT included, monthly, cancel any time. Card (Stripe) or crypto.
- The real-time WebSocket is the Builder plan (€99/mo): 3 connections, all 13 sports, all markets incl. alt lines, props and futures, 10 req/s REST, closing-odds history.
- Pricing claim, stated precisely: as of 9 November 2026 Builder at €99/mo (VAT incl.) was the lowest published monthly / 1-month price we found for a real-time WebSocket that carries live and prematch Pinnacle odds (see https://pinnfeed.io/compare for sources). A prematch-only WebSocket is published lower (oddssea Prematch $59/mo). On annual billing, odds-api.io Solo + WebSocket is ≈ €97.90/mo.
- Data: live and prematch Pinnacle prices (decimal and American), lines, max stake, margin, no-vig fair price and probability per outcome; 13 sports.
- WebSocket: wss://pinnfeed.io/v1/stream — snapshot first, then deltas; ping/pong every 20 s.
- REST: https://pinnfeed.io/v1 (sports, events, odds, drops, closing). Auth: x-api-key header.
- MCP: https://pinnfeed.io/mcp (Streamable HTTP; tools get_live_odds, get_prematch_odds, get_event, get_drops, get_closing_odds, search_events, list_sports, get_account).

## Docs
- [Quickstart](https://pinnfeed.io/docs): Get a PinnFeed API key and stream real-time Pinnacle odds over WebSocket in five minutes, with Python, Node.js and curl examples.
- [Authentication & API keys](https://pinnfeed.io/docs/authentication): How to authenticate PinnFeed REST and WebSocket requests with API keys, manage multiple keys, and keep them secure.
- [WebSocket protocol](https://pinnfeed.io/docs/websocket): PinnFeed odds WebSocket protocol reference - connect, subscribe filters, snapshot and delta messages, heartbeats, compression and close codes.
- [Schema reference](https://pinnfeed.io/docs/schema): PinnFeed odds data schema - event and market objects, outcomes with American, decimal and no-vig fair prices, market keys, periods and sport ids.
- [REST API](https://pinnfeed.io/docs/rest): PinnFeed REST API reference - sports, events, odds snapshots, single event and closing-line history endpoints with filters and pagination.
- [Examples](https://pinnfeed.io/docs/examples): Copy-paste examples for the PinnFeed odds API in Python, JavaScript (Node.js and browser) and curl - live book, +EV finder and closing-line value.
- [Plans & rate limits](https://pinnfeed.io/docs/limits): PinnFeed plan limits - WebSocket connections, REST rate limits, daily quotas, sports per plan, data delay and market depth.
- [Errors](https://pinnfeed.io/docs/errors): PinnFeed API error codes for REST and WebSocket, with HTTP status codes and how to handle each one.
- [MCP server for AI assistants](https://pinnfeed.io/docs/mcp): Connect Claude, Claude Code, Cursor, VS Code Copilot, Codex CLI or ChatGPT to live Pinnacle odds with PinnFeed's hosted MCP server.

## Pricing and comparisons
- [Pricing](https://pinnfeed.io/pricing): Free, Hobby, Builder (WebSocket), Pro, Enterprise
- [Pinnacle odds API alternatives: which provider fits which job](https://pinnfeed.io/alternatives): Alternatives to odds-api.io, The Odds API, OpticOdds, OddsJam and more: dated prices, when each provider fits. Checked 9 Nov 2026.
- [Lowest published monthly price for a live and prematch Pinnacle odds WebSocket](https://pinnfeed.io/cheapest-pinnacle-odds-websocket): As of 9 Nov 2026, PinnFeed Builder (€99/mo VAT incl.) was the lowest published monthly live + prematch Pinnacle WebSocket price we found.
- [Pinnacle odds API comparison: who streams Pinnacle prices, and what it costs](https://pinnfeed.io/compare): Who streams live + prematch Pinnacle odds over WebSocket: published plans, push vs polling and sources. Checked 9 November 2026.
- [PinnFeed frequently asked questions](https://pinnfeed.io/faq): PinnFeed FAQ: plans and prices, WebSocket plan, free trial, sports, fair odds, closing lines, MCP, crypto and cancellation.
- [odds-api.io alternative for a Pinnacle-only WebSocket](https://pinnfeed.io/odds-api-io-alternative): odds-api.io vs PinnFeed for a Pinnacle WebSocket: £98 vs €99 a month, annual billing, bookmakers and fair odds, and when odds-api.io is the better pick.
- [OddsJam alternatives for a Pinnacle odds feed](https://pinnfeed.io/oddsjam-alternative): The OddsJam API covers 100+ sportsbooks and is quote only. PinnFeed streams Pinnacle odds over WebSocket for €99/mo, published price. When each fits.
- [oddspush alternative with monthly card billing](https://pinnfeed.io/oddspush-alternative): oddspush: REST + WebSocket $138/mo prepaid in crypto, 1 connection. PinnFeed Builder: €99/mo, 3 connections, card billing. Checked 9 Nov 2026.
- [oddssea alternative for live and prematch Pinnacle odds](https://pinnfeed.io/oddssea-alternative): oddssea vs PinnFeed: $59 prematch-only and $149 live WebSocket plans vs Builder at €99/mo with 3 connections. Checked 9 Nov 2026, with when oddssea wins.
- [OpticOdds alternative for developers who want to start today](https://pinnfeed.io/opticodds-alternative): OpticOdds: quote-only, 200+ sportsbooks over SSE and RabbitMQ. PinnFeed: self-serve Pinnacle odds WebSocket at €99/mo. Which one fits, with sources.
- [pinnodds alternative with the WebSocket in the plan](https://pinnfeed.io/pinnodds-alternative): pinnodds: Pinnacle REST from $99/mo plus a $99 raw WebSocket add-on. PinnFeed Builder includes the WebSocket for €99/mo. Checked 9 Nov 2026.
- [pinnwire alternative with the WebSocket included](https://pinnfeed.io/pinnwire-alternative): pinnwire sells its raw Pinnacle WebSocket as a +$89 add-on ($178 with Pro). PinnFeed Builder includes it for €99/mo. Checked 9 Nov 2026.
- [Earn 30% of every payment, every month](https://pinnfeed.io/referral): Earn 30% of every payment your referrals make on PinnFeed, the real-time Pinnacle odds API, for as long as they stay subscribed. Card or crypto, paid out from €50.
- [Sportmonks alternative for Pinnacle odds](https://pinnfeed.io/sportmonks-alternative): Sportmonks: football data from €29/mo, odds as add-ons, Pinnacle marked limited/delayed in its docs. PinnFeed streams Pinnacle odds for €99/mo.
- [SportsDataIO alternative for live Pinnacle odds](https://pinnfeed.io/sportsdataio-alternative): SportsDataIO's self-serve odds plan is $99/mo, next-day data, personal use; live is quote only. PinnFeed streams live Pinnacle odds for €99/mo.
- [The Odds API alternative for real-time Pinnacle odds](https://pinnfeed.io/the-odds-api-alternative): The Odds API: REST polling from $30/mo across 100+ books. PinnFeed: live + prematch Pinnacle odds over WebSocket for €99/mo. When each fits.

## Answers (precise long-tail questions)
- [Detect steam moves on Pinnacle via API](https://pinnfeed.io/answers/detect-steam-moves-pinnacle-api): Detect Pinnacle steam moves and dropping odds in real time with the PinnFeed WebSocket rolling-window detector, or poll GET /v1/drops. Working thresholds and Python outline.
- [Dropping odds API](https://pinnfeed.io/answers/dropping-odds-api): List recent Pinnacle price drops with PinnFeed GET /v1/drops, or detect steam live on the Builder WebSocket. Query params, response fields and a curl example.
- [Free Pinnacle odds API](https://pinnfeed.io/answers/free-odds-api): PinnFeed Free is €0: REST snapshots with a 30-second delay, 2 sports, main markets, 1 req/s and 1,000 requests/day. No WebSocket. Honest limits and a curl example.
- [No-vig fair odds API](https://pinnfeed.io/answers/no-vig-fair-odds-api): Every PinnFeed market outcome includes no-vig fair decimal price and fairProb (multiplicative method), plus market margin. Use them for value betting without computing the vig yourself.
- [odds-api.io WebSocket price per month](https://pinnfeed.io/answers/odds-api-io-websocket-price): odds-api.io WebSocket pricing as of 9 November 2026: WebSocket is 2× the REST plan. Solo + WS is £98/mo or £980/yr (≈ €97.90/mo annual). 2 books on Solo. When it fits vs PinnFeed.
- [OddsJam API pricing](https://pinnfeed.io/answers/oddsjam-api-pricing): The OddsJam API does not publish prices as of 9 November 2026 (contact form). Push stream protocol is not named. Pinnacle is not named on the API page. When it fits vs PinnFeed.
- [oddspush WebSocket price per month](https://pinnfeed.io/answers/oddspush-websocket-price): oddspush.com WebSocket pricing as of 9 November 2026: REST + WebSocket is $138 for 1 month, $373 for 3 months, $662 for 6 months. Prepaid crypto. When it fits vs PinnFeed Builder €99.
- [oddssea vs PinnFeed](https://pinnfeed.io/answers/oddssea-vs-pinnfeed): Direct oddssea vs PinnFeed comparison for Pinnacle WebSocket shoppers as of 9 November 2026: Prematch $59, Live $149 vs PinnFeed Builder €99 live + prematch. Honest when-to-pick.
- [oddssea WebSocket price per month](https://pinnfeed.io/answers/oddssea-websocket-price): oddssea.dev published WebSocket prices as of 9 November 2026: Prematch $59/mo (prematch-only) and Live $149/mo (live + prematch). When each plan fits vs PinnFeed Builder €99.
- [OpticOdds pricing](https://pinnfeed.io/answers/opticodds-pricing): OpticOdds does not publish API prices; pricing is quote only as of 9 November 2026. FAQ: no WebSocket (SSE / RabbitMQ). When OpticOdds fits vs a self-serve Pinnacle WebSocket.
- [Get Pinnacle closing lines via API for CLV](https://pinnfeed.io/answers/pinnacle-closing-line-api-clv): Pull Pinnacle closing odds from PinnFeed /v1/closing and compute closing line value (CLV) against the no-vig fair price. Working curl and Python.
- [Pinnacle esports odds API](https://pinnfeed.io/answers/pinnacle-esports-odds-api): Access Pinnacle esports odds through PinnFeed with sport slug esports. REST snapshots and Builder WebSocket subscribe examples.
- [Pinnacle max stake (`maxStake`) via API](https://pinnfeed.io/answers/pinnacle-max-stake-api): Every PinnFeed market includes maxStake (maximum risk stake the source accepts). Use it to filter thin lines in steam detectors and value bots. REST and WebSocket field reference.
- [Pinnacle NBA moneyline odds API in real time](https://pinnfeed.io/answers/pinnacle-nba-moneyline-odds-api): Stream or poll Pinnacle NBA (basketball) moneyline odds in real time with the PinnFeed API. Sport slug is basketball; working REST and WebSocket examples.
- [Pinnacle NFL odds API (american-football)](https://pinnfeed.io/answers/pinnacle-nfl-american-football-odds-api): Stream or poll Pinnacle NFL and college football odds with PinnFeed. The sport slug is american-football (not nfl). REST and WebSocket examples.
- [Pinnacle odds API for Google Sheets and Excel](https://pinnfeed.io/answers/pinnacle-odds-api-google-sheets-excel): Pull Pinnacle odds into Google Sheets with Apps Script or into Excel via Power Query / Python against the PinnFeed REST API. Free plan works for a delayed board.
- [Pinnacle odds in ChatGPT and Claude (MCP)](https://pinnfeed.io/answers/pinnacle-odds-chatgpt-mcp): Connect ChatGPT, Claude or Cursor to live Pinnacle odds with PinnFeed's hosted MCP server at https://pinnfeed.io/mcp. Setup headers, tools list and example prompts.
- [How to get Pinnacle odds in Python (REST)](https://pinnfeed.io/answers/pinnacle-odds-python-rest): Fetch Pinnacle odds in Python with requests against the PinnFeed REST API. Works on the Free plan (30 s delay). Upgrade to Builder for the WebSocket client.
- [Pinnacle odds WebSocket Node.js reconnect](https://pinnfeed.io/answers/pinnacle-odds-websocket-nodejs-reconnect): Node.js WebSocket client for PinnFeed that answers pings, rebuilds the book from snapshots and reconnects with exponential backoff plus jitter after close codes like 1001.
- [Pinnacle odds WebSocket price per month](https://pinnfeed.io/answers/pinnacle-odds-websocket-price-per-month): Published monthly prices for a Pinnacle odds WebSocket as of 9 November 2026: PinnFeed Builder €99 (live + prematch), oddssea Prematch $59 / Live $149, oddspush $138, pinnwire $178, odds-api.io £98. Sources dated.
- [Pinnacle odds WebSocket Python example](https://pinnfeed.io/answers/pinnacle-odds-websocket-python-example): Working Python example that connects to the PinnFeed Pinnacle odds WebSocket, subscribes, applies snapshot and delta frames, answers pings and reconnects with backoff.
- [Pinnacle soccer corners odds API](https://pinnfeed.io/answers/pinnacle-soccer-corners-odds-api): Read Pinnacle soccer corner markets from PinnFeed by filtering related soccer events whose units are Corners. Main corner lines on every plan with soccer; alternate lines on Builder.
- [Pinnacle tennis odds API](https://pinnfeed.io/answers/pinnacle-tennis-odds-api): Fetch or stream Pinnacle tennis odds with PinnFeed. Sport slug tennis; moneyline, spread and totals over REST or the Builder WebSocket.
- [pinnodds WebSocket price per month](https://pinnfeed.io/answers/pinnodds-websocket-price): pinnodds WebSocket pricing as of 9 November 2026: Raw WebSocket is a +$99/mo add-on, so the cheapest plan with a WebSocket is Pro $99 + WS $99 = $198/mo. Neutral facts vs PinnFeed Builder €99.
- [pinnwire WebSocket price per month](https://pinnfeed.io/answers/pinnwire-websocket-price): pinnwire.com WebSocket pricing as of 9 November 2026: Raw WebSocket is a +$89/mo add-on on Pro, so the cheapest full-book WS is $178/mo. Drops $89 is SSE only.
- [Sportmonks and Pinnacle odds](https://pinnfeed.io/answers/sportmonks-pinnacle-odds): Sportmonks marks Pinnacle as limited/delayed on Standard odds and not listed on Premium prematch (checked 9 Nov 2026). No WebSocket/push for odds found. Football data API from €29/mo.
- [SportsDataIO odds price](https://pinnfeed.io/answers/sportsdataio-odds-price): SportsDataIO Discovery Lab Odds is $99/mo or $599/yr for next-day delayed personal-use data (9 Nov 2026). Real-time Leagues API is quote only. Pinnacle not named on pages read.
- [Telegram picks bot on Pinnacle odds](https://pinnfeed.io/answers/telegram-picks-bot-pinnacle): Post Pinnacle steam moves to a Telegram channel with a ~70-line Node bot on the PinnFeed WebSocket. BotFather setup, dry-run mode and Builder requirement.
- [Does The Odds API have a WebSocket?](https://pinnfeed.io/answers/the-odds-api-websocket): The Odds API has no WebSocket or push feed at any published price. It is REST polling from a free 500-credit tier and paid plans from $30/mo. PinnFeed Builder adds a live + prematch Pinnacle WebSocket at €99/mo.
- [Value betting API](https://pinnfeed.io/answers/value-betting-api): Build a value (+EV) checker with the PinnFeed API: read fair and fairProb on Pinnacle markets, compare to a soft-book decimal, compute EV. Working Python outline.
- [Answers to precise Pinnacle odds API questions](https://pinnfeed.io/answers): Short, answer-first pages for exact developer and bettor questions about the PinnFeed Pinnacle odds API and WebSocket: Python, Node, CLV, steam, sports, Sheets, free plan, MCP, Telegram and competitor WebSocket prices.

## Guides
- [Stream Pinnacle odds over WebSocket in Python and Node](https://pinnfeed.io/guides/pinnacle-odds-websocket-python-node): Connect to the PinnFeed WebSocket from Python or Node: snapshot, deltas, pings and reconnect with backoff. Copy-paste code.
- [Detect dropping odds and steam moves on Pinnacle in real time](https://pinnfeed.io/guides/dropping-odds-steam-detection): Detect steam moves and dropping odds on Pinnacle in real time: a rolling-window drop detector in Python on the PinnFeed WebSocket, with max-stake filtering and the /v1/drops REST shortcut.
- [Value betting against soft books with Pinnacle's no-vig fair odds](https://pinnfeed.io/guides/value-betting-no-vig-fair-odds): Find +EV soft-book prices with Pinnacle no-vig fair odds from PinnFeed: EV, margin removal and Kelly, with Python code.
- [Track closing line value against Pinnacle's closing price](https://pinnfeed.io/guides/closing-line-value-clv-tracking): Measure closing line value against Pinnacle no-vig closers via PinnFeed /v1/closing. Python + SQLite tracker.
- [Build a Telegram picks bot on live Pinnacle odds](https://pinnfeed.io/guides/telegram-picks-bot): A Node.js Telegram bot that posts Pinnacle steam moves as picks in real time, from the PinnFeed WebSocket. BotFather setup, dry-run mode and the full code.
- [Use live Pinnacle odds inside ChatGPT and Claude with MCP](https://pinnfeed.io/guides/pinnacle-odds-chatgpt-claude-mcp): Connect ChatGPT, Claude or Cursor to live Pinnacle odds via PinnFeed MCP. Setup, tools and example prompts.
- [Pull Pinnacle odds into Google Sheets](https://pinnfeed.io/guides/pinnacle-odds-google-sheets): Pull Pinnacle moneylines into Google Sheets with Apps Script and the PinnFeed REST API. Works on the Free plan.

## Other languages
- [Español (es)](https://pinnfeed.io/llms-es.txt): páginas en español (API de cuotas de Pinnacle, precios, comparativa, FAQ y guías)
- [Português (Brasil) (pt-BR)](https://pinnfeed.io/llms-pt-br.txt): páginas em português do Brasil (API de odds da Pinnacle, preços, comparativo, FAQ e guias)
- [Deutsch (de)](https://pinnfeed.io/llms-de.txt): deutsche Seiten (Pinnacle-Quoten-API, Preise, Vergleich, FAQ und Anleitungen)
- [Italiano (it)](https://pinnfeed.io/llms-it.txt): pagine in italiano (API delle quote Pinnacle, prezzi, confronto, FAQ e guide)
- [Français (fr)](https://pinnfeed.io/llms-fr.txt): pages en français (API de cotes Pinnacle, tarifs, comparatif, FAQ et guides)
- [日本語 (ja)](https://pinnfeed.io/llms-ja.txt): 日本語のページ（ピナクルのオッズAPI、料金、比較、FAQ、ガイド）

## Optional
- [Structured pricing (markdown)](https://pinnfeed.io/pricing.md): plans, limits and EUR prices for agents
- [OpenAPI 3.1](https://pinnfeed.io/openapi.json): machine-readable REST (+ WebSocket notes) for API directories
- [Full text for LLMs](https://pinnfeed.io/llms-full.txt): every page above in one Markdown file
- [Pinnacle odds API](https://pinnfeed.io/pinnacle-odds-api) · [Odds WebSocket API](https://pinnfeed.io/odds-websocket-api) · [Closing-line odds data](https://pinnfeed.io/closing-line-odds-data) · [MCP server](https://pinnfeed.io/pinnacle-odds-mcp)