sharpapi 0.3.3__tar.gz → 0.4.1__tar.gz

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

@@ -2,6 +2,41 @@
 
 All notable changes to the `sharpapi` Python SDK are documented here.
 
+## 0.4.1 — 2026-06-02
+
+### Added — structured `team_side` + `market_segment` (issue #76 / #689)
+
+- `OddsLine`, `EVOpportunity`, and `ClosingOddsLine` gain two optional fields:
+  - `team_side` — the raw structured side (`"home"` | `"away"` | `"draw"`)
+    decomposed out of the compound `selection_type` vocabulary. Prefer this over
+    parsing compound prefixes like `"home_over"`.
+  - `market_segment` — the canonical contest slice (`"full_game"`, `"1st_half"`,
+    `"1st_5_innings"`, ...).
+- Both are additive and default to `None`; existing code is unaffected. The API
+  continues to emit the compound `selection_type` for back-compat.
+
+## 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.1}/PKG-INFO

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sharpapi"
-version = "0.3.3"
+version = "0.4.1"
 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.1}/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.1}/src/sharpapi/models.py

@@ -214,13 +214,26 @@ class OddsLine(BaseModel):
     market_type: str
     selection: str
     selection_type: str | None = None
+    # Structured side/segment axes (issue #76 / #689). team_side is the raw
+    # "home"|"away"|"draw" decomposed out of the compound selection_type vocab;
+    # market_segment is the contest slice ("full_game", "1st_half", ...). Both
+    # optional + additive — absent on rows the adapter didn't stamp.
+    team_side: str | None = None
+    market_segment: str | None = None
     odds_american: int | float
     odds_decimal: float
     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
@@ -286,6 +299,9 @@ class EVOpportunity(BaseModel):
     detected_at: str | None = None
     external_event_id: str | None = None
     selection_id: str | None = None
+    # Structured side/segment axes (issue #76 / #689), additive + optional.
+    team_side: str | None = None
+    market_segment: str | None = None
     # Optional structured refs (additive, non-breaking).
     home: TeamRef | None = None
     away: TeamRef | None = None
@@ -311,6 +327,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
@@ -563,6 +581,9 @@ class ClosingOddsLine(BaseModel):
     market_type: str
     selection: str
     selection_type: str | None = None
+    # Structured side/segment axes (issue #76 / #689), additive + optional.
+    team_side: str | None = None
+    market_segment: str | None = None
     odds_american: int | float
     odds_decimal: float
     line: float | None = None