pinnapi 0.1.0__py3-none-any.whl

pinnapi-0.1.0.dist-info/METADATA

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: pinnapi
+Version: 0.1.0
+Summary: Real-time Pinnacle odds & drop alerts in Python — REST snapshots and SSE drop streams from pinnapi.com, the drop-in alternative to the closed Pinnacle API.
+Project-URL: Homepage, https://pinnapi.com
+Project-URL: Documentation, https://pinnapi.com/docs
+Project-URL: API reference (LLM-friendly), https://pinnapi.com/llms-full.txt
+Project-URL: Blog, https://pinnapi.com/blog
+Author-email: pinnapi <info@pinnapi.com>
+License: MIT
+License-File: LICENSE
+Keywords: arbitrage,betting,closing-line-value,dropping-odds,odds,odds-api,pinnacle,pinnacle-api,sports-betting,sse,steam-moves
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.20
+Description-Content-Type: text/markdown
+
+# pinnapi — Pinnacle odds API for Python
+
+Real-time **Pinnacle odds and drop alerts** in Python: REST snapshots of live + prematch markets, and Server-Sent-Events streams that push every odds drop to your code in **~15–40 ms**.
+
+```bash
+pip install pinnapi
+```
+
+> **Does Pinnacle still have a public API?** No — Pinnacle closed its public API on **July 23, 2025** (only bespoke commercial/academic access remains). [pinnapi.com](https://pinnapi.com) is an independent drop-in replacement: the same familiar response shape, served from its own real-time feed. No Pinnacle account needed — your API key is your login, and a free trial key takes seconds (no card).
+
+## Quickstart
+
+```python
+from pinnapi import Client, SPORTS
+
+api = Client("YOUR_KEY")  # free trial key at https://pinnapi.com/
+
+# Live soccer markets (moneyline, spreads, totals, team totals — every period)
+events = api.markets(sport_id=SPORTS["soccer"])
+
+# Prematch instead of live
+fixtures = api.prematch_fixtures(sport_id=SPORTS["tennis"])
+
+# What just dropped? (queryable buffer, no open connection needed)
+recent = api.drops(mode="live", min_drop_pct=5)
+```
+
+## Real-time drop alerts (SSE)
+
+Stream every market whose price falls past your threshold, the instant it happens — this is the feed for steam chasing, dropping-odds alerts, and arbitrage windows:
+
+```python
+# Requires a plan with SSE (Drops / Edge / Scale)
+for drop in api.stream_drops(mode="live", min_drop=5):
+    print(f'{drop["home"]} v {drop["away"]} · {drop["market"]} '
+          f'{drop["from"]} → {drop["to"]} (▼{drop["drop_pct"]}%)')
+```
+
+`mode="prematch"` streams pre-game drops (optional `recheck=N` holds an alert N seconds and re-verifies before sending). Reconnects automatically on network hiccups; auth/plan errors raise immediately.
+
+## Why Pinnacle's line?
+
+Pinnacle is the market's reference price — the sharp line the rest of the market follows. When it breaks, soft books take seconds to correct; everything in between is your window. A polled aggregator hears about the move on its next cycle; this feed is **push, not poll**.
+
+## API surface
+
+| Method | Endpoint | What it returns |
+|---|---|---|
+| `markets(sport_id, event_type)` | `GET /kit/v1/markets` | Live (default) or prematch markets for a sport |
+| `details(event_id)` | `GET /kit/v1/details` | One live event |
+| `prematch_fixtures(sport_id)` | `GET /kit/v1/prematch/fixtures` | All prematch fixtures + markets |
+| `prematch_markets(event_id)` | `GET /kit/v1/prematch/markets` | Markets for one prematch event |
+| `prematch_lines(event_id)` | `GET /kit/v1/prematch/lines` | Compact line view |
+| `drops(mode, ...)` | `GET /api/drops` | Recent dropping-odds buffer (filterable) |
+| `stream_drops(mode, min_drop)` | SSE `/odds-drop[-prematch]` | Push stream of drop alerts |
+| `health()` / `ping()` | `GET /health` / `/ping` | Service status / liveness |
+
+**Sports** (`SPORTS` dict): soccer=1, tennis=2, basketball=3, hockey=4, football=5, baseball=6, rugby=7, mma=8, boxing=9, other=10, esports=11, golf=12.
+
+**Errors:** `AuthError` (bad key / plan lacks the surface), `RateLimitError` (with `.retry_after` seconds), `PinnapiError` (everything else, with `.status` and `.payload`).
+
+## Pricing & limits
+
+Free trial: 100 REST requests/day, no card. Paid plans from **$99/mo** (SSE drop streams, 10–30 req/sec REST, raw WebSocket add-on). Full details: [pinnapi.com](https://pinnapi.com/#pricing) · [API docs](https://pinnapi.com/docs) · [LLM-friendly reference](https://pinnapi.com/llms-full.txt).
+
+## Notes
+
+- Real-time feed only (live + prematch) — no historical archive; buffer the stream yourself if you need history.
+- One concurrent SSE connection per account per stream (live and prematch counted separately).
+- pinnapi is an independent service, **not affiliated with or endorsed by Pinnacle**.
+
+MIT licensed.

pinnapi-0.1.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+pinnapi-0.1.0.dist-info/METADATA,sha256=DW0sgBj74GY878rf-BSjhgrxnIkwkOAf22js5m0WoTs,5141
+pinnapi-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+pinnapi-0.1.0.dist-info/licenses/LICENSE,sha256=hjw4s88WJXDj94V0H5PadZs98nVxorBiObVm7Egqgis,1078
+pinnapi-0.1.0.dist-info/RECORD,,

pinnapi-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

pinnapi-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pinnapi (pinnapi.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.