pinnapi 0.1.0__tar.gz

pinnapi-0.1.0/.gitignore

@@ -0,0 +1,86 @@
+# ═══ Production repo — what NOT to track ═══
+
+# Dependencies
+node_modules/
+
+# Local SaaS data (SQLite, logs)
+data/
+*.db
+*.db-journal
+*.db-shm
+*.db-wal
+*.log
+
+# Pinnacle session + auth tokens (contain secrets)
+session*.json
+
+# Blog content published at runtime via the admin SEO Builder. Written on the
+# live server (markdown source + manifest), NOT via git. Untracked files
+# survive the deploy webhook's `git reset --hard`, so posts persist across
+# deploys. Sitemap/RSS/index/post HTML are all rendered on the fly from these.
+content/blog/
+fresh_token.*
+login_body.json
+login_probe.json
+
+# Ad-hoc monitor captures / snapshots
+manual_monitor_report.json
+live_monitor_report.json
+monitor_stdout.log
+manual_monitor.log
+api-server.log
+ws_diag.log
+ws_messages.jsonl
+live_odds.jsonl
+pinnacle_sample.json
+probe_detail.json
+tennis_snapshot.json
+js_chunks/
+snapshots/
+snapshots_tennis/
+
+# Exploratory / reverse-engineering scratch (kept locally, not shipped)
+.playwright-mcp/
+*.py
+__pycache__/
+.venv/
+ws_diag.js
+ws_topic_scan.js
+prematch_probe.js
+probe_tennis.js
+saas-test.js
+tools/race/logs/
+
+# Environment files (NOWPAYMENTS secrets, DB URLs)
+.env
+.env.*
+
+# OS / editor cruft
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+.idea/
+.vscode/
+
+# Local scratch / explorations / credentials
+tmp/
+.claude/
+
+# ─── Bet-tracking WIP (uncommitted, not deployed) ───────────────────────────
+# Local-only experiment from May 2026. Tied to a MariaDB setup we haven't
+# stood up on the VPS yet. Keep the files around but hidden from git so they
+# can't be accidentally pushed. To resume work, remove these lines.
+drops/bet-scorer.js
+drops/db-store.js
+drops/mqtt-settler.js
+drops/tests/bet-scorer.test.js
+drops/tests/min-drop.test.js
+drops/tests/mqtt-settler.test.js
+public/bets.html
+api-server.js.bak-with-uncommitted
+banner-on-panel.png
+
+# Installed agent skills (npx skills add ...) — local tooling, not product code
+.agents/
+skills-lock.json

pinnapi-0.1.0/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.

pinnapi-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,72 @@
+# 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/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pinnapi"
+version = "0.1.0"
+description = "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."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+authors = [{ name = "pinnapi", email = "info@pinnapi.com" }]
+keywords = [
+  "pinnacle", "pinnacle-api", "odds", "odds-api", "betting", "sports-betting",
+  "arbitrage", "dropping-odds", "steam-moves", "closing-line-value", "sse",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = ["requests>=2.20"]
+
+[project.urls]
+Homepage = "https://pinnapi.com"
+Documentation = "https://pinnapi.com/docs"
+"API reference (LLM-friendly)" = "https://pinnapi.com/llms-full.txt"
+Blog = "https://pinnapi.com/blog"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pinnapi"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/pinnapi", "README.md", "LICENSE", "tests"]