feat(sdk): add Odds.closing, Events.markets, Keys CRUD

Three coverage gaps in the Python SDK against the live REST surface:

- Odds.closing(event_id, sportsbook=None) → GET /odds/closing
 Returns ClosingSnapshot with per-book ClosingOddsLine arrays.
- Events.markets(event_id) → GET /events/{event_id}/markets
 Returns APIResponse[list[Market]] with market enumeration.
- Keys namespace → full CRUD on /account/keys
 list() — GET /account/keys
 create(name) — POST /account/keys
 revoke(key_id) — DELETE /account/keys/{key_id}
 rotate(key_id) — POST /account/keys/{key_id}/rotate

Sync (client.py) and async (async_client.py) parity. New models
(Market, ClosingOddsLine, ClosingSnapshot, APIKey) re-exported
from the package root.

Bumped 0.2.3 → 0.2.4. Pyright 0/0, pytest 87/87.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Mlaz-code

pyproject.toml

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

src/sharpapi/__init__.py

@@ -32,15 +32,19 @@
 )
 from .models import (
     AccountInfo,
+    APIKey,
     APIResponse,
     ArbitrageLeg,
     ArbitrageOpportunity,
+    ClosingOddsLine,
+    ClosingSnapshot,
     Event,
     EVOpportunity,
     GameState,
     League,
     LowHoldOpportunity,
     LowHoldSide,
+    Market,
     MiddleOpportunity,
     MiddleSide,
     OddsLine,
@@ -53,23 +57,27 @@
 )
 from .streaming import EventStream
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"
 
 __all__ = [
     # Clients
     "SharpAPI",
     "AsyncSharpAPI",
     # Models
+    "APIKey",
     "APIResponse",
     "AccountInfo",
     "ArbitrageLeg",
     "ArbitrageOpportunity",
+    "ClosingOddsLine",
+    "ClosingSnapshot",
     "EVOpportunity",
     "Event",
     "GameState",
     "League",
     "LowHoldOpportunity",
     "LowHoldSide",
+    "Market",
     "MiddleOpportunity",
     "MiddleSide",
     "OddsLine",

src/sharpapi/_base.py

@@ -19,7 +19,7 @@
 
 DEFAULT_BASE_URL = "https://api.sharpapi.io"
 DEFAULT_TIMEOUT = 30.0
-USER_AGENT = "sharpapi-python/0.2.3"
+USER_AGENT = "sharpapi-python/0.2.4"
 
 RETRY_STATUSES = frozenset({502, 503, 504})
 RETRY_MAX_ATTEMPTS = 3

src/sharpapi/async_client.py

@@ -21,12 +21,15 @@
 from ._utils import _clean_params
 from .models import (
     AccountInfo,
+    APIKey,
     APIResponse,
     ArbitrageOpportunity,
+    ClosingSnapshot,
     Event,
     EVOpportunity,
     League,
     LowHoldOpportunity,
+    Market,
     MiddleOpportunity,
     OddsLine,
     RateLimitInfo,
@@ -86,6 +89,7 @@ def __init__(
         self.sportsbooks = _AsyncSportsbooksResource(self)
         self.events = _AsyncEventsResource(self)
         self.account = _AsyncAccountResource(self)
+        self.keys = _AsyncKeysResource(self)
 
     @property
     def rate_limit(self) -> RateLimitInfo:
@@ -223,6 +227,25 @@ async def batch(self, event_ids: list[str]) -> APIResponse[list[OddsLine]]:
         data = await self._client._post("/odds/batch", {"event_ids": event_ids})
         return parse_response(data, OddsLine)
 
+    async def closing(
+        self,
+        event_id: str,
+        *,
+        sportsbook: str | None = None,
+    ) -> ClosingSnapshot:
+        """Get closing-line snapshot for an event.
+
+        Returns the captured closing odds grouped by sportsbook. If no
+        closing data has been captured for the event, the returned
+        ``ClosingSnapshot.books`` mapping will be empty.
+        """
+        data = await self._client._get("/odds/closing", {
+            "event_id": event_id,
+            "sportsbook": sportsbook or None,
+        })
+        raw = data.get("data", data)
+        return ClosingSnapshot.model_validate(raw)
+
 
 class _AsyncEVResource:
     """Async access to +EV opportunities."""
@@ -461,6 +484,11 @@ async def get(self, event_id: str) -> Event:
         raw = data.get("data", data)
         return Event.model_validate(raw)
 
+    async def markets(self, event_id: str) -> APIResponse[list[Market]]:
+        """List the markets available on a specific event."""
+        data = await self._client._get(f"/events/{event_id}/markets")
+        return parse_response(data, Market)
+
 
 class _AsyncAccountResource:
     def __init__(self, client: AsyncSharpAPI):
@@ -476,3 +504,33 @@ async def usage(self) -> dict:
         """Get current usage stats."""
         data = await self._client._get("/account/usage")
         return data.get("data", data)
+
+
+class _AsyncKeysResource:
+    """Async access to API key CRUD on the current account."""
+
+    def __init__(self, client: AsyncSharpAPI):
+        self._client = client
+
+    async def list(self) -> APIResponse[list[APIKey]]:
+        """List all API keys on the account."""
+        data = await self._client._get("/account/keys")
+        return parse_response(data, APIKey)
+
+    async def create(self, name: str) -> APIKey:
+        """Create a new API key. Returned ``APIKey.key`` is shown only once."""
+        data = await self._client._post("/account/keys", {"name": name})
+        raw = data.get("data", data)
+        return APIKey.model_validate(raw)
+
+    async def revoke(self, key_id: str) -> None:
+        """Revoke (delete) an API key by ID."""
+        await self._client._request("DELETE", f"/account/keys/{key_id}")
+
+    async def rotate(self, key_id: str) -> APIKey:
+        """Rotate an API key — issues a new key and revokes the old one."""
+        data = await self._client._post(f"/account/keys/{key_id}/rotate")
+        raw = data.get("data", data)
+        if isinstance(raw, dict) and "new_key" in raw:
+            return APIKey.model_validate(raw["new_key"])
+        return APIKey.model_validate(raw)

src/sharpapi/client.py

@@ -21,12 +21,15 @@
 from ._utils import _clean_params
 from .models import (
     AccountInfo,
+    APIKey,
     APIResponse,
     ArbitrageOpportunity,
+    ClosingSnapshot,
     Event,
     EVOpportunity,
     League,
     LowHoldOpportunity,
+    Market,
     MiddleOpportunity,
     OddsLine,
     RateLimitInfo,
@@ -95,6 +98,7 @@ def __init__(
         self.sportsbooks = _SportsbooksResource(self)
         self.events = _EventsResource(self)
         self.account = _AccountResource(self)
+        self.keys = _KeysResource(self)
         self.stream = _StreamResource(self)
 
     @property
@@ -248,6 +252,29 @@ def batch(self, event_ids: list[str]) -> APIResponse[list[OddsLine]]:
         data = self._client._post("/odds/batch", {"event_ids": event_ids})
         return _parse_response(data, OddsLine)
 
+    def closing(
+        self,
+        event_id: str,
+        *,
+        sportsbook: str | None = None,
+    ) -> ClosingSnapshot:
+        """Get closing-line snapshot for an event.
+
+        Returns the captured closing odds grouped by sportsbook. If no
+        closing data has been captured for the event, the returned
+        ``ClosingSnapshot.books`` mapping will be empty.
+
+        Args:
+            event_id: Event ID to fetch closing odds for.
+            sportsbook: Optional sportsbook filter (single book ID).
+        """
+        data = self._client._get("/odds/closing", {
+            "event_id": event_id,
+            "sportsbook": sportsbook or None,
+        })
+        raw = data.get("data", data)
+        return ClosingSnapshot.model_validate(raw)
+
 
 class _EVResource:
     """Access +EV opportunities."""
@@ -574,6 +601,11 @@ def get(self, event_id: str) -> Event:
         raw = data.get("data", data)
         return Event.model_validate(raw)
 
+    def markets(self, event_id: str) -> APIResponse[list[Market]]:
+        """List the markets available on a specific event."""
+        data = self._client._get(f"/events/{event_id}/markets")
+        return _parse_response(data, Market)
+
 
 class _AccountResource:
     def __init__(self, client: SharpAPI):
@@ -591,6 +623,50 @@ def usage(self) -> dict:
         return data.get("data", data)
 
 
+class _KeysResource:
+    """Manage API keys on the current account.
+
+    Wraps the ``/account/keys`` CRUD endpoints. Requires authentication
+    with a key whose user has permission to manage keys (typically a
+    dashboard-issued key).
+    """
+
+    def __init__(self, client: SharpAPI):
+        self._client = client
+
+    def list(self) -> APIResponse[list[APIKey]]:
+        """List all API keys on the account."""
+        data = self._client._get("/account/keys")
+        return _parse_response(data, APIKey)
+
+    def create(self, name: str) -> APIKey:
+        """Create a new API key.
+
+        Returns the new ``APIKey`` including the one-time ``key`` secret
+        in ``APIKey.key``. Store it securely — it will not be shown again.
+        """
+        data = self._client._post("/account/keys", {"name": name})
+        raw = data.get("data", data)
+        return APIKey.model_validate(raw)
+
+    def revoke(self, key_id: str) -> None:
+        """Revoke (delete) an API key by ID."""
+        self._client._request("DELETE", f"/account/keys/{key_id}")
+
+    def rotate(self, key_id: str) -> APIKey:
+        """Rotate an API key — issues a new key and revokes the old one.
+
+        Returns the newly created ``APIKey`` (including the one-time
+        ``key`` secret).
+        """
+        data = self._client._post(f"/account/keys/{key_id}/rotate")
+        raw = data.get("data", data)
+        # Rotate response shape is {"data": {"new_key": {...}, "old_key": {...}}}
+        if isinstance(raw, dict) and "new_key" in raw:
+            return APIKey.model_validate(raw["new_key"])
+        return APIKey.model_validate(raw)
+
+
 class _StreamResource:
     """Build SSE stream connections."""
 

src/sharpapi/models.py

@@ -406,6 +406,67 @@ class Event(BaseModel):
     status: str | None = None
 
 
+class Market(BaseModel):
+    """A market available on an event."""
+
+    market_type: str
+    market_label: str | None = None
+    selection_count: int | None = None
+    book_count: int | None = None
+    books: list[str] | None = None
+
+
+# =============================================================================
+# Closing Snapshot
+# =============================================================================
+
+
+class ClosingOddsLine(BaseModel):
+    """A single closing-line odds entry within a closing snapshot."""
+
+    sportsbook: str
+    market_type: str
+    selection: str
+    selection_type: str | None = None
+    odds_american: int | float
+    odds_decimal: float
+    line: float | None = None
+    player_name: str | None = None
+    stat_category: str | None = None
+
+
+class ClosingSnapshot(BaseModel):
+    """Closing-line snapshot for an event, grouped by sportsbook."""
+
+    event_id: str
+    sport: str | None = None
+    league: str | None = None
+    home_team: str | None = None
+    away_team: str | None = None
+    event_start_time: str | None = None
+    captured_at: str | None = None
+    books: dict[str, list[ClosingOddsLine]] = Field(default_factory=dict)
+
+
+# =============================================================================
+# Account / Keys
+# =============================================================================
+
+
+class APIKey(BaseModel):
+    """An API key managed via the /account/keys endpoints."""
+
+    id: str
+    id_masked: str | None = None
+    # Present only on create/rotate responses (one-time secret).
+    key: str | None = None
+    name: str | None = None
+    tier: str | None = None
+    is_active: bool | None = None
+    created_at: str | None = None
+    updated_at: str | None = None
+
+
 # =============================================================================
 # Account
 # =============================================================================