Pinnacle Odds API Documentation: Where It Went, and What to Read Instead

Pinnacle's API documentation went dark in the 2025 shutdown. What the old docs covered, where working documentation lives now, and the response shape.

Pinnacle Odds API Documentation: Where It Went, and What to Read Instead

If you searched for Pinnacle API documentation and landed on dead links, you found the right page for the wrong reason. The short version: the official Pinnacle odds API documentation no longer exists for the public. Pinnacle closed its public API on 23 July 2025, and the docs went dark with the endpoints. Everything below is about what that documentation used to describe, and where working, current documentation for a Pinnacle odds feed actually lives in 2026.

What happened to the official docs

For roughly a decade, Pinnacle published developer documentation for its customer API — the reference behind a whole ecosystem of odds tools, GitHub wrappers, and Stack Overflow answers. When public access closed, the documentation portal followed. What survives is folklore: cached copies, abandoned client libraries, and tutorials that still rank in search while pointing at endpoints that return errors. (A community mirror of the old reference exists on GitHub for archaeology, but the endpoints it documents won't answer without a commercial partnership.)

That's why this search is frustrating in 2026: the top results describe an API you can no longer call.

What the old documentation described — and why it still matters

The old API's data model is worth understanding because the ecosystem standardized on it, and current replacements deliberately mirror it: fixtures → markets → prices. An event (fixture), the questions asked about it (moneyline, spreads, totals — per period), and the odds on each answer. Decimal odds, stable integer IDs, versioned responses for incremental polling. If you've read our field-by-field tour of the format, you've effectively read the modern version of those docs.

That continuity is the reason migration from old Pinnacle code is usually an afternoon: the shape survived the API that invented it.

Where working documentation lives now

Disclosure applies from here: pinnapi is our product, an independent drop-in replacement feed. Its documentation is the closest thing to "Pinnacle odds API documentation" that you can actually build against today:

• The API reference — every endpoint with copy-paste examples in curl, Node, Python, Go, and PHP: live markets (/kit/v1/markets), single events, prematch fixtures, the dropping-odds buffer, and the SSE push streams. Auth is one header (x-portal-apikey); no Pinnacle account is involved.
• The Postman collection — the whole surface, importable by URL, with per-request docs and a sport-ID legend.
• llms-full.txt — the entire reference as one plain-text file sized for AI coding assistants. Hand it to Cursor or Claude and ask for a client.
• SDK documentation — pip install pinnapi and npm install pinnapi ship typed clients whose READMEs double as quickstarts; the docs page covers both.

The five-minute orientation

The current documentation in miniature, so you know what you're walking into:

# One header, one endpoint, a full live soccer board
curl -H "x-portal-apikey: $KEY" \
  "https://pinnapi.com/kit/v1/markets?sport_id=1&event_type=live"

Responses arrive as { sport_id, sport_name, last, events: [...] } — each event carrying its periods tree (num_0 = full match), with money_line, spreads and totals keyed by their lines, exactly the structure broken down here. The last counter powers incremental polling. Push delivery (SSE) and server-side drop alerts are where the old API never went — that part of the documentation has no 2015 equivalent.

If you don't want our docs

Fair enough — the honest alternatives, documented by their own vendors: broad aggregators carry Pinnacle among many books (The Odds API's docs are genuinely good, with the caveat that their Pinnacle data is website-sourced), and enterprise routes exist for licensed operations. The full map of your options is here. What no longer exists, from anyone, is official public Pinnacle documentation — every current path is third-party.

FAQ

Where is the official Pinnacle API documentation? Gone — Pinnacle removed public API access and its developer documentation in July 2025. Only commercial partners get documentation directly from Pinnacle now.

Is there a working replacement with real documentation? Yes — third-party feeds document their Pinnacle-sourced APIs fully. Ours is at pinnapi.com/docs with examples in five languages, a Postman collection, and an AI-readable llms.txt.

Does the old Pinnacle response format still exist anywhere? Effectively yes — replacement feeds kept the fixtures → markets → prices shape, so old parsing code mostly ports over. The format is documented field by field here.

Do I need a Pinnacle account to use a documented odds API? No — every realistic option authenticates with an API key, not a betting account. An account wouldn't grant API access anyway since the shutdown.