# PinnWire — Real-Time Pinnacle Odds API

> PinnWire (https://pinnwire.com) is a real-time Pinnacle sports odds API. Live and prematch odds for 13 sports (soccer, tennis, basketball, hockey, football, baseball, rugby, MMA, boxing, volleyball/handball, esports, golf, cricket) delivered over REST, WebSocket push, and SSE odds-drop alerts. Free trial key with no credit card. Paid plans from $89/month — cheaper than comparable Pinnacle odds APIs. Drop-in compatible with common third-party Pinnacle API response formats: switching usually means changing only the base URL.

## Setup for AI agents

- Public demo key: use `key=demo` on any REST endpoint right now — no signup (10 req/min, 50/day). Example: https://pinnwire.com/v1/health?key=demo
- Agent setup prompt: https://pinnwire.com/agent-setup/prompt.md — read-only steps, no credentials involved.
- Free personal key (100/day): the user enters their email at https://pinnwire.com — takes 5 seconds.

## Key endpoints

- GET /kit/v1/markets?sport_id=1&key=KEY — live odds for a sport (decimal), moneyline/spreads/totals per period
- GET /kit/v1/prematch/fixtures?sport_id=1&key=KEY — upcoming fixtures with odds
- GET /kit/v1/details?event_id=N&key=KEY — one event
- GET /api/drops?mode=live&min_drop_pct=5&key=KEY — recent price drops with no-vig fair price (nvp)
- SSE /odds-drop?key=KEY&min_drop=5 — pushed drop alerts (paid plans)
- WS wss://pinnwire.com/ws?key=KEY — raw real-time firehose (add-on)

## Docs

- Documentation: https://pinnwire.com/docs.html
- Comparison of Pinnacle odds APIs: https://pinnwire.com/compare.html
- Pricing: Trial $0 · Pro $89/mo · Pro+Drops $139/mo · Scale $219/mo · Raw WS +$89/mo

## Notes

- sport_id: 1 Soccer, 2 Tennis, 3 Basketball, 4 Hockey, 5 Football, 6 Baseball, 7 Rugby, 8 MMA, 9 Boxing, 10 Volleyball/Handball, 11 Esports, 12 Golf, 13 Cricket
- Data service only, not a bookmaker. 18+. Not affiliated with Pinnacle.