sharpapi 0.1.0__tar.gz → 0.2.1__tar.gz

sharpapi-0.2.1/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install hatch
+
+      - name: Build
+        run: hatch build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

sharpapi-0.2.1/.github/workflows/test.yml

@@ -0,0 +1,28 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[test,pandas]"
+
+      - name: Run tests
+        run: pytest -v

sharpapi-0.2.1/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+.pytest_cache/
+.ruff_cache/
+*.egg
+.mypy_cache/

{sharpapi-0.1.0 → sharpapi-0.2.1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: sharpapi
-Version: 0.1.0
+Version: 0.2.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
-Project-URL: Repository, https://github.com/sharpapi/sharpapi-python
-Project-URL: Changelog, https://github.com/sharpapi/sharpapi-python/releases
+Project-URL: Repository, https://github.com/Sharp-API/sharpapi-python
+Project-URL: Changelog, https://github.com/Sharp-API/sharpapi-python/releases
 Author-email: SharpAPI <support@sharpapi.io>
 License-Expression: MIT
 Keywords: api,arbitrage,ev,odds,pinnacle,real-time,sports-betting
@@ -60,9 +60,9 @@ for arb in arbs.data:
 # --- +EV opportunities ---
 evs = client.ev.get(min_ev=3.0, sport="basketball")
 for opp in evs.data:
-    print(f"+{opp.ev_percent:.1f}% EV on {opp.selection} @ {opp.sportsbook}")
-    if opp.kelly_fraction:
-        print(f"  Kelly: {opp.kelly_fraction:.1%} of bankroll")
+    print(f"+{opp.ev_percentage:.1f}% EV on {opp.selection} @ {opp.sportsbook}")
+    if opp.kelly_percent:
+        print(f"  Kelly: {opp.kelly_percent:.1%} of bankroll")
 
 # --- Best odds across books ---
 odds = client.odds.best(league="nba", market="moneyline")
@@ -80,7 +80,7 @@ stream = client.stream.opportunities(league="nba")
 @stream.on("ev:detected")
 def on_ev(data):
     for opp in data:
-        print(f"+EV: {opp['selection']} {opp['ev_percent']}% @ {opp['sportsbook']}")
+        print(f"+EV: {opp['selection']} {opp['ev_percentage']}% @ {opp['sportsbook']}")
 
 @stream.on("arb:detected")
 def on_arb(data):
@@ -118,7 +118,6 @@ client.sports.list()
 client.leagues.list(sport="basketball")
 client.sportsbooks.list()
 client.events.list(league="nba", live=True)
-client.events.search("Lakers")
 
 # Account
 client.account.me()       # Tier, limits, features

{sharpapi-0.1.0 → sharpapi-0.2.1}/README.md

@@ -27,9 +27,9 @@ for arb in arbs.data:
 # --- +EV opportunities ---
 evs = client.ev.get(min_ev=3.0, sport="basketball")
 for opp in evs.data:
-    print(f"+{opp.ev_percent:.1f}% EV on {opp.selection} @ {opp.sportsbook}")
-    if opp.kelly_fraction:
-        print(f"  Kelly: {opp.kelly_fraction:.1%} of bankroll")
+    print(f"+{opp.ev_percentage:.1f}% EV on {opp.selection} @ {opp.sportsbook}")
+    if opp.kelly_percent:
+        print(f"  Kelly: {opp.kelly_percent:.1%} of bankroll")
 
 # --- Best odds across books ---
 odds = client.odds.best(league="nba", market="moneyline")
@@ -47,7 +47,7 @@ stream = client.stream.opportunities(league="nba")
 @stream.on("ev:detected")
 def on_ev(data):
     for opp in data:
-        print(f"+EV: {opp['selection']} {opp['ev_percent']}% @ {opp['sportsbook']}")
+        print(f"+EV: {opp['selection']} {opp['ev_percentage']}% @ {opp['sportsbook']}")
 
 @stream.on("arb:detected")
 def on_arb(data):
@@ -85,7 +85,6 @@ client.sports.list()
 client.leagues.list(sport="basketball")
 client.sportsbooks.list()
 client.events.list(league="nba", live=True)
-client.events.search("Lakers")
 
 # Account
 client.account.me()       # Tier, limits, features

{sharpapi-0.1.0 → sharpapi-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sharpapi"
-version = "0.1.0"
+version = "0.2.1"
 description = "Official Python SDK for the SharpAPI real-time sports betting odds API"
 readme = "README.md"
 license = "MIT"
@@ -36,8 +36,8 @@ test = ["pytest>=8.0", "pytest-asyncio>=0.23", "respx>=0.21"]
 [project.urls]
 Homepage = "https://sharpapi.io"
 Documentation = "https://docs.sharpapi.io/sdks/python"
-Repository = "https://github.com/sharpapi/sharpapi-python"
-Changelog = "https://github.com/sharpapi/sharpapi-python/releases"
+Repository = "https://github.com/Sharp-API/sharpapi-python"
+Changelog = "https://github.com/Sharp-API/sharpapi-python/releases"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/sharpapi"]
@@ -56,3 +56,5 @@ testpaths = ["tests"]
 [tool.pyright]
 pythonVersion = "3.9"
 typeCheckingMode = "standard"
+venvPath = "."
+venv = ".venv"

{sharpapi-0.1.0 → sharpapi-0.2.1}/src/sharpapi/__init__.py

@@ -14,7 +14,7 @@ Example::
     # +EV opportunities
     evs = client.ev.get(min_ev=3.0, league="nba")
     for opp in evs.data:
-        print(f"+{opp.ev_percent}% on {opp.selection} @ {opp.sportsbook}")
+        print(f"+{opp.ev_percentage}% on {opp.selection} @ {opp.sportsbook}")
 """
 
 from .async_client import AsyncSharpAPI
@@ -51,7 +51,7 @@ from .models import (
 from .streaming import EventStream
 from ._utils import american_to_decimal, american_to_probability, decimal_to_american
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"
 
 __all__ = [
     # Clients

{sharpapi-0.1.0 → sharpapi-0.2.1}/src/sharpapi/_base.py

@@ -2,8 +2,6 @@
 
 from __future__ import annotations
 
-from typing import Any
-
 import httpx
 
 from .exceptions import (
@@ -17,7 +15,7 @@ from .models import APIResponse, RateLimitInfo, ResponseMeta
 
 DEFAULT_BASE_URL = "https://api.sharpapi.io"
 DEFAULT_TIMEOUT = 30.0
-USER_AGENT = "sharpapi-python/0.1.0"
+USER_AGENT = "sharpapi-python/0.2.0"
 
 
 def parse_response(raw: dict, model_class: type) -> APIResponse:

{sharpapi-0.1.0 → sharpapi-0.2.1}/src/sharpapi/async_client.py

@@ -442,11 +442,6 @@ class _AsyncEventsResource:
         raw = data.get("data", data)
         return Event.model_validate(raw)
 
-    async def search(self, query: str) -> APIResponse[list[Event]]:
-        """Search events by name."""
-        data = await self._client._get("/events/search", {"q": query})
-        return parse_response(data, Event)
-
 
 class _AsyncAccountResource:
     def __init__(self, client: AsyncSharpAPI):

{sharpapi-0.1.0 → sharpapi-0.2.1}/src/sharpapi/client.py

@@ -52,7 +52,7 @@ class SharpAPI:
         # Get +EV opportunities
         evs = client.ev.get(min_ev=3.0, league="nba")
         for opp in evs.data:
-            print(f"+{opp.ev_percent}% on {opp.selection} @ {opp.sportsbook}")
+            print(f"+{opp.ev_percentage}% on {opp.selection} @ {opp.sportsbook}")
 
         # Stream real-time updates
         stream = client.stream.opportunities(league="nba")
@@ -555,11 +555,6 @@ class _EventsResource:
         raw = data.get("data", data)
         return Event.model_validate(raw)
 
-    def search(self, query: str) -> APIResponse[list[Event]]:
-        """Search events by name."""
-        data = self._client._get("/events/search", {"q": query})
-        return _parse_response(data, Event)
-
 
 class _AccountResource:
     def __init__(self, client: SharpAPI):

{sharpapi-0.1.0 → sharpapi-0.2.1}/src/sharpapi/models.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from typing import Any, Generic, List, Optional, TypeVar
 
-from pydantic import BaseModel, Field
+from pydantic import AliasChoices, BaseModel, Field
 
 T = TypeVar("T")
 
@@ -171,14 +171,22 @@ class EVOpportunity(BaseModel):
     odds_american: int | float
     odds_decimal: float
     no_vig_odds: Optional[float] = None
-    true_probability: Optional[float] = None
-    ev_percent: float = Field(alias="ev_percent")
-    kelly_fraction: Optional[float] = None
+    fair_probability: Optional[float] = Field(
+        None, validation_alias=AliasChoices("fair_probability", "true_probability")
+    )
+    ev_percentage: float = Field(
+        validation_alias=AliasChoices("ev_percentage", "ev_percent")
+    )
+    kelly_percent: Optional[float] = Field(
+        None, validation_alias=AliasChoices("kelly_percent", "kelly_fraction")
+    )
     confidence_score: Optional[float] = None
     book_count: Optional[int] = None
     market_width: Optional[float] = None
     devig_method: Optional[str] = None
-    devig_book: Optional[str] = None
+    sharp_book: Optional[str] = Field(
+        None, validation_alias=AliasChoices("sharp_book", "devig_book")
+    )
     sharp_odds_american: Optional[int | float] = None
     sharp_odds_decimal: Optional[float] = None
     line: Optional[float] = None

{sharpapi-0.1.0 → sharpapi-0.2.1}/tests/conftest.py

@@ -91,13 +91,17 @@ EV_RESPONSE = {
             "odds_american": -105,
             "odds_decimal": 1.952,
             "no_vig_odds": 1.912,
+            "fair_probability": 0.523,
             "true_probability": 0.523,
+            "ev_percentage": 4.2,
             "ev_percent": 4.2,
+            "kelly_percent": 0.021,
             "kelly_fraction": 0.021,
             "confidence_score": 87,
             "book_count": 8,
             "market_width": 0.043,
             "devig_method": "power",
+            "sharp_book": "pinnacle",
             "devig_book": "pinnacle",
             "is_live": False,
             "possibly_stale": False,

{sharpapi-0.1.0 → sharpapi-0.2.1}/tests/test_async_client.py

@@ -174,7 +174,7 @@ class TestAsyncOpportunities:
             result = await client.ev.get(min_ev=3.0)
             assert len(result.data) == 1
             assert isinstance(result.data[0], EVOpportunity)
-            assert result.data[0].ev_percent == 4.2
+            assert result.data[0].ev_percentage == 4.2
 
 
 # =============================================================================

{sharpapi-0.1.0 → sharpapi-0.2.1}/tests/test_client.py

@@ -260,8 +260,8 @@ class TestEVResource:
             assert len(result.data) == 1
             ev = result.data[0]
             assert isinstance(ev, EVOpportunity)
-            assert ev.ev_percent == 4.2
-            assert ev.kelly_fraction == 0.021
+            assert ev.ev_percentage == 4.2
+            assert ev.kelly_percent == 0.021
 
 
 class TestMiddlesResource:
@@ -346,15 +346,6 @@ class TestReferenceResources:
             result = client.events.list(league="nba")
             assert len(result.data) == 1
 
-    @respx.mock
-    def test_events_search(self):
-        respx.get(f"{BASE_URL}/api/v1/events/search").mock(
-            return_value=Response(200, json=EVENTS_RESPONSE)
-        )
-        with SharpAPI(API_KEY) as client:
-            result = client.events.search("Lakers")
-            assert len(result.data) == 1
-
     @respx.mock
     def test_account_me(self):
         respx.get(f"{BASE_URL}/api/v1/account").mock(

{sharpapi-0.1.0 → sharpapi-0.2.1}/tests/test_dataframe.py

@@ -22,7 +22,7 @@ class TestToDataFrame:
         result = parse_response(EV_RESPONSE, EVOpportunity)
         df = result.to_dataframe()
         assert len(df) == 1
-        assert df.iloc[0]["ev_percent"] == 4.2
+        assert df.iloc[0]["ev_percentage"] == 4.2
         assert df.iloc[0]["sportsbook"] == "draftkings"
 
     def test_flattens_nested_dicts(self):
@@ -60,24 +60,24 @@ class TestToDataFrame:
                     "id": "ev_1", "sport": "basketball", "league": "nba",
                     "selection": "A", "sportsbook": "dk",
                     "odds_american": -110, "odds_decimal": 1.909,
-                    "ev_percent": 4.2, "possibly_stale": False, "warnings": [],
+                    "ev_percentage": 4.2, "possibly_stale": False, "warnings": [],
                 },
                 {
                     "id": "ev_2", "sport": "basketball", "league": "nba",
                     "selection": "B", "sportsbook": "fd",
                     "odds_american": 130, "odds_decimal": 2.3,
-                    "ev_percent": 2.8, "possibly_stale": False, "warnings": [],
+                    "ev_percentage": 2.8, "possibly_stale": False, "warnings": [],
                 },
             ],
         }
         result = parse_response(multi, EVOpportunity)
         df = result.to_dataframe()
         assert len(df) == 2
-        assert list(df["ev_percent"]) == [4.2, 2.8]
+        assert list(df["ev_percentage"]) == [4.2, 2.8]
         assert list(df["sportsbook"]) == ["dk", "fd"]
 
     def test_dataframe_dtypes(self):
         result = parse_response(EV_RESPONSE, EVOpportunity)
         df = result.to_dataframe()
-        assert df["ev_percent"].dtype == "float64"
+        assert df["ev_percentage"].dtype == "float64"
         assert "str" in str(df["sportsbook"].dtype).lower() or df["sportsbook"].dtype == "object"

{sharpapi-0.1.0 → sharpapi-0.2.1}/tests/test_models.py

@@ -74,7 +74,7 @@ class TestEVModel:
         result = parse_response(EV_RESPONSE, EVOpportunity)
         assert len(result.data) == 1
         ev = result.data[0]
-        assert ev.ev_percent == 4.2
+        assert ev.ev_percentage == 4.2
         assert ev.selection == "PHO Suns"
         assert ev.sportsbook == "draftkings"
         assert ev.odds_american == -105
@@ -84,15 +84,15 @@ class TestEVModel:
         result = parse_response(EV_RESPONSE, EVOpportunity)
         ev = result.data[0]
         assert ev.devig_method == "power"
-        assert ev.devig_book == "pinnacle"
+        assert ev.sharp_book == "pinnacle"
         assert ev.no_vig_odds == 1.912
-        assert ev.true_probability == 0.523
+        assert ev.fair_probability == 0.523
 
     def test_scoring(self):
         result = parse_response(EV_RESPONSE, EVOpportunity)
         ev = result.data[0]
         assert ev.confidence_score == 87
-        assert ev.kelly_fraction == 0.021
+        assert ev.kelly_percent == 0.021
         assert ev.book_count == 8
 
     def test_aliased_fields(self):