pinnwire

Real-time Pinnacle odds API client. Live + prematch odds for 13 sports, dropping-odds alerts, no-vig fair prices. requests-only, fully typed.

Pinnacle closed its public API in July 2025 — PinnWire is an independent real-time feed. The public demo key works with no signup:

from pinnwire import Client, SPORTS

api = Client("demo")  # public demo key — try it right now

board = api.markets(SPORTS["SOCCER"])                  # live soccer odds, decimal
drops = api.drops(mode="live", min_drop_pct=5)          # what just dropped
print(drops["drops"][0])  # {home, away, market, from, to, drop_pct, nvp, ...}

Streaming drop alerts (paid plans)

api = Client(os.environ["PINNWIRE_KEY"])
for d in api.stream_drops(min_drop=5):
    print(d["home"], "v", d["away"], d["from_price"], "->", d["to_price"], "fair:", d["nvp"])

Auto-reconnects with backoff. stream_drops(prematch=True, recheck=30) streams prematch drops re-verified after 30s.

All methods

markets · prematch_fixtures · details · prematch_lines · drops · stream_drops · health

include_specials=1 unlocks player props, exact scores, futures. 429s are retried automatically honoring Retry-After.

Keys & pricing

demo = public key, 10 req/min, REST only. Free personal key (100/day forever, no card) at pinnwire.com. Paid plans from $89/mo. Full docs: pinnwire.com/docs.html · plain-text API reference for LLMs: pinnwire.com/llms-full.txt

18+ · data service, not a bookmaker · not affiliated with Pinnacle.