sharpapi 0.3.3__tar.gz → 0.4.0__tar.gz

{sharpapi-0.3.3 → sharpapi-0.4.0}/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to the `sharpapi` Python SDK are documented here.
 
+## 0.4.0 — 2026-06-02
+
+### Changed
+
+- `OddsLine.timestamp` / `ArbitrageLeg.timestamp` documented as the **delivery /
+  last-refreshed** feed-freshness timestamp (advances every ingest cycle),
+  matching OpticOdds' `timestamp` — NOT a price-last-changed time. The API now
+  populates this field (previously always `null`). The removed
+  `odds_changed_at` / `last_seen_at` / `wire_received_at` were never modeled by
+  this SDK, so no model change is needed. (SHA-1048)
+
+### Added
+
+- `OddsLine.is_active` (bool, default `True`). `False` indicates the market is
+  suspended/closed with the price frozen — mirrors OpticOdds `locked-odds` but
+  as a queryable field. Absent on the wire is treated as `True`.
+
+### Backward compatibility
+
+- Additive optional field with a `True` default — existing code is unaffected,
+  and older API servers that omit the key parse as active.
+
 ## 0.3.2 — 2026-05-07
 
 ### Changed

{sharpapi-0.3.3 → sharpapi-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharpapi
-Version: 0.3.3
+Version: 0.4.0
 Summary: Official Python SDK for the SharpAPI real-time sports betting odds API
 Project-URL: Homepage, https://sharpapi.io
 Project-URL: Documentation, https://docs.sharpapi.io/sdks/python

{sharpapi-0.3.3 → sharpapi-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sharpapi"
-version = "0.3.3"
+version = "0.4.0"
 description = "Official Python SDK for the SharpAPI real-time sports betting odds API"
 readme = "README.md"
 license = "MIT"

{sharpapi-0.3.3 → sharpapi-0.4.0}/src/sharpapi/__init__.py

@@ -61,7 +61,7 @@ from .models import (
 )
 from .streaming import EventStream
 
-__version__ = "0.3.1"
+__version__ = "0.4.0"
 
 __all__ = [
     # Clients

{sharpapi-0.3.3 → sharpapi-0.4.0}/src/sharpapi/models.py

@@ -219,8 +219,15 @@ class OddsLine(BaseModel):
     probability: float
     line: float | None = None
     event_start_time: str | None = None
+    # ISO 8601 — when SharpAPI last refreshed this odd through its pipeline
+    # (advances every ingest cycle). A feed-freshness / delivery signal matching
+    # OpticOdds' `timestamp`; NOT a price-last-changed time. (SHA-1048)
     timestamp: str | None = None
     is_live: bool = False
+    # True (default) = market open and bettable; False = market suspended/closed
+    # with the price frozen (mirrors OpticOdds locked-odds). Absent on the wire
+    # is treated as True. SHA-3803.
+    is_active: bool = True
     deep_link: str | None = None
     player_name: str | None = None
     stat_category: str | None = None
@@ -311,6 +318,8 @@ class ArbitrageLeg(BaseModel):
     odds_decimal: float
     implied_probability: float | None = None
     stake_percent: float
+    # ISO 8601 last-refreshed (feed-freshness) timestamp for this leg's odd —
+    # see OddsLine.timestamp. (SHA-1048)
     timestamp: str | None = None
     external_event_id: str | None = None
     selection_id: str | None = None