sharpapi 0.3.2__tar.gz → 0.4.0__tar.gz

{sharpapi-0.3.2 → sharpapi-0.4.0}/.gitignore

@@ -14,5 +14,4 @@ build/
 htmlcov/
 .claude/
 .DS_Store
-tests/
 .benchmarks/

{sharpapi-0.3.2 → 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.2 → sharpapi-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sharpapi
-Version: 0.3.2
+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.2 → sharpapi-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sharpapi"
-version = "0.3.2"
+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.2 → 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.2 → sharpapi-0.4.0}/src/sharpapi/_base.py

@@ -33,6 +33,15 @@ RETRY_BASE_DELAY = 0.5
 RETRY_MAX_DELAY = 4.0
 
 
+def normalize_base_url(base_url: str) -> str:
+    """Return the API origin URL, accepting values with a trailing /api/v1."""
+    cleaned = base_url.rstrip("/")
+    suffix = "/api/v1"
+    if cleaned.endswith(suffix):
+        return cleaned[: -len(suffix)]
+    return cleaned
+
+
 def should_retry(response: httpx.Response | None, exc: Exception | None) -> bool:
     """True for transient upstream failures worth retrying."""
     if exc is not None:

{sharpapi-0.3.2 → sharpapi-0.4.0}/src/sharpapi/async_client.py

@@ -15,6 +15,7 @@ from ._base import (
     AuthMethod,
     handle_errors,
     make_headers,
+    normalize_base_url,
     parse_rate_limit,
     parse_response,
     retry_delay,
@@ -89,7 +90,7 @@ class AsyncSharpAPI:
 
         self._api_key = api_key
         self._auth_method: AuthMethod = auth_method
-        self._base_url = base_url.rstrip("/")
+        self._base_url = normalize_base_url(base_url)
         self._timeout = timeout
         self._http = httpx.AsyncClient(
             base_url=f"{self._base_url}/api/v1",

{sharpapi-0.3.2 → sharpapi-0.4.0}/src/sharpapi/client.py

@@ -15,6 +15,7 @@ from ._base import (
     AuthMethod,
     handle_errors,
     make_headers,
+    normalize_base_url,
     parse_rate_limit,
     parse_response,
     retry_delay,
@@ -97,7 +98,7 @@ class SharpAPI:
 
         self._api_key = api_key
         self._auth_method: AuthMethod = auth_method
-        self._base_url = base_url.rstrip("/")
+        self._base_url = normalize_base_url(base_url)
         self._timeout = timeout
         self._http = httpx.Client(
             base_url=f"{self._base_url}/api/v1",

{sharpapi-0.3.2 → 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