ps3838api 0.1.0__py3-none-any.whl

ps3838api/matching.py

@@ -0,0 +1,106 @@
+from rapidfuzz import fuzz
+from ps3838api import ROOT_DIR
+from ps3838api.logic import normalize_to_set
+from ps3838api.models.event import (
+    Failure,
+    MatchedLeague,
+    NoSuchEvent,
+    NoSuchLeague,
+    NoSuchLeagueFixtures,
+    NoSuchLeagueMatching,
+    WrongLeague,
+)
+
+import ps3838api.api as ps
+
+import json
+from typing import Final
+
+from ps3838api.models.fixtures import FixturesLeagueV3, FixturesResponse
+from ps3838api.models.tank import EventInfo
+
+
+with open(ROOT_DIR / "out/matched_leagues.json") as file:
+    MATCHED_LEAGUES: Final[list[MatchedLeague]] = json.load(file)
+
+with open(ROOT_DIR / "out/ps3838_leagues.json") as file:
+    ALL_LEAGUES: Final[list[ps.LeagueV3]] = json.load(file)['leagues']
+
+
+def match_league(
+    *,
+    league_betsapi: str,
+    leagues_mapping: list[MatchedLeague] = MATCHED_LEAGUES,
+) -> MatchedLeague | NoSuchLeagueMatching | WrongLeague:
+    for league in leagues_mapping:
+        if league["betsapi_league"] == league_betsapi:
+            if league["ps3838_id"]:
+                return league
+            else:
+                return NoSuchLeagueMatching(league_betsapi)
+    return WrongLeague(league_betsapi)
+
+
+def find_league_by_name(
+    league: str, leagues: list[ps.LeagueV3] = ALL_LEAGUES
+) -> ps.LeagueV3 | NoSuchLeague:
+    normalized = normalize_to_set(league)
+    for leagueV3 in leagues:
+        if normalize_to_set(leagueV3["name"]) == normalized:
+            return leagueV3
+    return NoSuchLeagueMatching(league)
+
+
+def find_event_in_league(
+    league_data: FixturesLeagueV3, league: str, home: str, away: str
+) -> EventInfo | NoSuchEvent:
+    """
+    Scans `league_data["events"]` for the best fuzzy match to `home` and `away`.
+    Returns the matching event with the highest sum of match scores, as long as
+    that sum >= 75 (which is 37.5% of the max possible 200).
+    Otherwise, returns NoSuchEvent.
+    """
+    best_event = None
+    best_sum_score = 0
+    for event in league_data["events"]:
+        # Compare the user-provided home and away vs. the fixture's home and away.
+        # Using token_set_ratio (see below for comparison vs token_sort_ratio).
+        score_home = fuzz.token_set_ratio(home, event.get("home", ""))
+        score_away = fuzz.token_set_ratio(away, event.get("away", ""))
+        total_score = score_home + score_away
+        if total_score > best_sum_score:
+            best_sum_score = total_score
+            best_event = event
+    # If the best event's combined fuzzy match is < 37.5% of the total possible 200,
+    # treat it as no match:
+    if best_event is None or best_sum_score < 75:
+        return NoSuchEvent(league, home, away)
+    return {"eventId": best_event["id"], "leagueId": league_data["id"]}
+
+
+def magic_find_event(
+    fixtures: FixturesResponse, league: str, home: str, away: str
+) -> EventInfo | Failure:
+    """
+    1. Tries to find league by normalizng names;
+    2. If don't, search for a league matching
+    3. Then `find_event_in_league`
+    """
+
+    leagueV3 = find_league_by_name(league)
+    if isinstance(leagueV3, NoSuchLeague):
+        match match_league(league_betsapi=league):
+            case {"ps3838_id": int()} as value:
+                league_id: int = value["ps3838_id"]  # type: ignore
+            case _:
+                return NoSuchLeagueMatching(league)
+    else:
+        league_id = leagueV3["id"]
+
+    for leagueV3 in fixtures["league"]:
+        if leagueV3["id"] == league_id:
+            break
+    else:
+        return NoSuchLeagueFixtures(league)
+
+    return find_event_in_league(leagueV3, league, home, away)

ps3838api/models/bets.py

@@ -0,0 +1,249 @@
+from typing import TypedDict, NotRequired, Literal
+
+type OddsFormat = Literal["AMERICAN", "DECIMAL", "HONGKONG", "INDONESIAN", "MALAY"]
+
+type FillType = Literal["NORMAL", "FILLANDKILL", "FILLMAXLIMIT"]
+"""
+### NORMAL
+bet will be placed on specified stake.  
+
+### FILLANDKILL
+
+If the stake is over the max limit, bet will be placed on max limit, 
+otherwise it will be placed on specified stake.  
+
+### FILLMAXLIMIT⚠️
+
+bet will be places on max limit⚠️, stake amount will be ignored. 
+Please note that maximum limits can change at any moment, which may result in 
+risking more than anticipated. This option is replacement of isMaxStakeBet from 
+v1/bets/place'
+"""
+
+type Team = Literal["TEAM1", "TEAM2", "DRAW"]
+type Side = Literal["OVER", "UNDER"]
+
+type BetStatus = Literal[
+    "ACCEPTED",
+    "CANCELLED",
+    "LOSE",
+    "PENDING_ACCEPTANCE",
+    "REFUNDED",
+    "NOT_ACCEPTED",
+    "WON",
+    "REJECTED",
+]
+
+type BetStatus2 = Literal[
+    "ACCEPTED",
+    "CANCELLED",
+    "LOST",
+    "PENDING_ACCEPTANCE",
+    "REFUNDED",
+    "NOT_ACCEPTED",
+    "WON",
+    "REJECTED",
+    "HALF_WON_HALF_PUSHED",
+    "HALF_LOST_HALF_PUSHED",
+]
+
+type BetType = Literal["MONEYLINE", "TEAM_TOTAL_POINTS", "SPREAD", "TOTAL_POINTS"]
+
+type BetTypeFull = Literal[
+    "MONEYLINE",
+    "TEAM_TOTAL_POINTS",
+    "SPREAD",
+    "TOTAL_POINTS",
+    "SPECIAL",
+    "PARLAY",
+    "TEASER",
+    "MANUAL",
+]
+
+
+class PlaceStraightBetRequest(TypedDict):
+    oddsFormat: OddsFormat
+    uniqueRequestId: str
+    acceptBetterLine: bool
+    stake: float
+    winRiskStake: Literal["WIN", "RISK"]
+    lineId: int
+    altLineId: NotRequired[int]
+    pitcher1MustStart: bool
+    pitcher2MustStart: bool
+    fillType: Literal["NORMAL", "FILLANDKILL", "FILLMAXLIMIT"]
+    sportId: int
+    eventId: int
+    periodNumber: int
+    betType: BetTypeFull
+    team: Literal["TEAM1", "TEAM2", "DRAW"]
+    side: NotRequired[Literal["OVER", "UNDER"]]
+    handicap: NotRequired[float]
+
+
+class CancellationDetails(TypedDict):
+    key: str
+    value: str
+
+
+class CancellationReason(TypedDict):
+    code: str
+    details: list[CancellationDetails]
+
+
+class StraightBet(TypedDict):
+    betId: int
+    wagerNumber: int
+    placedAt: str
+    betStatus: Literal[
+        "ACCEPTED",
+        "CANCELLED",
+        "LOSE",
+        "PENDING_ACCEPTANCE",
+        "REFUNDED",
+        "NOT_ACCEPTED",
+        "WON",
+    ]
+    betType: BetTypeFull
+    win: float
+    risk: float
+    oddsFormat: OddsFormat
+    updateSequence: int
+    price: float
+    winLoss: NotRequired[float]
+    customerCommission: NotRequired[float]
+    cancellationReason: NotRequired[CancellationReason]
+    handicap: NotRequired[float]
+    side: NotRequired[Literal["OVER", "UNDER"]]
+    pitcher1: NotRequired[str]
+    pitcher2: NotRequired[str]
+    pitcher1MustStart: NotRequired[str]
+    pitcher2MustStart: NotRequired[str]
+    teamName: NotRequired[str]
+    team1: NotRequired[str]
+    team2: NotRequired[str]
+    periodNumber: NotRequired[int]
+    team1Score: NotRequired[float]
+    team2Score: NotRequired[float]
+    ftTeam1Score: NotRequired[float]
+    ftTeam2Score: NotRequired[float]
+    pTeam1Score: NotRequired[float]
+    pTeam2Score: NotRequired[float]
+    isLive: Literal["true", "false"]
+
+
+class PlaceStraightBetResponse(TypedDict):
+    status: Literal["ACCEPTED", "PENDING_ACCEPTANCE", "PROCESSED_WITH_ERROR"]
+    uniqueRequestId: str
+    errorCode: NotRequired[
+        Literal[
+            "ALL_BETTING_CLOSED",
+            "ALL_LIVE_BETTING_CLOSED",
+            "ABOVE_EVENT_MAX",
+            "ABOVE_MAX_BET_AMOUNT",
+            "BELOW_MIN_BET_AMOUNT",
+            "BLOCKED_BETTING",
+            "BLOCKED_CLIENT",
+            "INSUFFICIENT_FUNDS",
+            "INVALID_COUNTRY",
+            "INVALID_EVENT",
+            "INVALID_ODDS_FORMAT",
+            "LINE_CHANGED",
+            "LISTED_PITCHERS_SELECTION_ERROR",
+            "OFFLINE_EVENT",
+            "PAST_CUTOFFTIME",
+            "RED_CARDS_CHANGED",
+            "SCORE_CHANGED",
+            "DUPLICATE_UNIQUE_REQUEST_ID",
+            "INCOMPLETE_CUSTOMER_BETTING_PROFILE",
+            "INVALID_CUSTOMER_PROFILE",
+            "LIMITS_CONFIGURATION_ISSUE",
+            "RESPONSIBLE_BETTING_LOSS_LIMIT_EXCEEDED",
+            "RESPONSIBLE_BETTING_RISK_LIMIT_EXCEEDED",
+            "RESUBMIT_REQUEST",
+            "SYSTEM_ERROR_3",
+            "LICENCE_RESTRICTION_LIVE_BETTING_BLOCKED",
+            "INVALID_HANDICAP",
+            "BETTING_SUSPENDED",
+        ]
+    ]
+    straightBet: NotRequired[StraightBet]
+
+
+from typing import TypedDict, NotRequired, Literal
+
+
+class CancellationDetailsV3(TypedDict):
+    key: str
+    value: str
+
+
+class CancellationReasonV3(TypedDict):
+    code: str
+    details: list[CancellationDetailsV3]
+
+
+class StraightBetV3(TypedDict):
+    betId: int
+    wagerNumber: int
+    placedAt: str
+    betStatus: BetStatus
+    betStatus2: BetStatus2
+    betType: BetTypeFull
+    win: float
+    risk: float
+    oddsFormat: OddsFormat
+    updateSequence: int
+    price: float
+    isLive: bool
+    eventStartTime: str
+
+    # Optional fields (use NotRequired for fields that may be absent)
+    winLoss: NotRequired[float | None]
+    customerCommission: NotRequired[float | None]
+    cancellationReason: NotRequired[CancellationReasonV3]
+    sportId: NotRequired[int]
+    leagueId: NotRequired[int]
+    eventId: NotRequired[int]
+    handicap: NotRequired[float | None]
+    teamName: NotRequired[str]
+    side: NotRequired[Literal["OVER", "UNDER"] | None]
+    pitcher1: NotRequired[str | None]
+    pitcher2: NotRequired[str | None]
+    pitcher1MustStart: NotRequired[bool | None]
+    pitcher2MustStart: NotRequired[bool | None]
+    team1: NotRequired[str]
+    team2: NotRequired[str]
+    periodNumber: NotRequired[int]
+    team1Score: NotRequired[float | None]
+    team2Score: NotRequired[float | None]
+    ftTeam1Score: NotRequired[float | None]
+    ftTeam2Score: NotRequired[float | None]
+    pTeam1Score: NotRequired[float | None]
+    pTeam2Score: NotRequired[float | None]
+    resultingUnit: NotRequired[str]
+
+
+# Not implemented placeholders:
+class ParlayBetV2(TypedDict): ...
+
+
+class TeaserBet(TypedDict): ...
+
+
+class SpecialBetV3(TypedDict): ...
+
+
+class ManualBet(TypedDict): ...
+
+
+class BetsResponse(TypedDict):
+    moreAvailable: bool
+    pageSize: int
+    fromRecord: int
+    toRecord: int
+    straightBets: list[StraightBetV3]
+    parlayBets: list[ParlayBetV2]
+    teaserBets: list[TeaserBet]
+    specialBets: list[SpecialBetV3]
+    manualBets: list[ManualBet]

ps3838api/models/errors.py

@@ -0,0 +1,42 @@
+from dataclasses import dataclass
+
+
+class BasePS3838Error(Exception):
+    pass
+
+
+class ResponseError(BasePS3838Error):
+    pass
+
+
+class AccessBlockedError(ResponseError):
+    """
+    Raised when the API returns an empty response, likely due to access restrictions.
+
+    This may not be a strict rate limit. In many cases, it indicates that the account
+    needs to meet certain behavioral criteria — such as placing $30–$40 in manual bets per day —
+    before automated requests are allowed again.
+    """
+
+    pass
+
+
+class WrongEndpoint(ResponseError):
+    """405 HTTP Error"""
+
+    pass
+
+
+@dataclass
+class PS3838APIError(ResponseError):
+    code: str | None
+    message: str | None
+
+
+class LogicError(BasePS3838Error):
+    """Raised when there is a violation of client-side logic or input invariant."""
+    pass
+
+
+class BaseballOnlyArgumentError(LogicError):
+    pass

ps3838api/models/event.py

@@ -0,0 +1,57 @@
+from dataclasses import dataclass
+from typing import TypedDict
+
+
+class MatchedLeague(TypedDict):
+    betsapi_league: str
+    ps3838_league: str | None
+    ps3838_id: int | None
+
+
+#######################################
+# Return Types For the Matching Tanks #
+#######################################
+
+
+@dataclass
+class NoSuchLeague:
+    league: str
+
+
+@dataclass
+class NoSuchLeagueMatching(NoSuchLeague):
+    pass
+
+
+@dataclass
+class NoSuchLeagueFixtures(NoSuchLeague):
+    pass
+
+@dataclass
+class WrongLeague(NoSuchLeague):
+    pass
+
+
+@dataclass
+class NoSuchEvent:
+    league: str
+    home: str
+    away: str
+
+@dataclass
+class EventTooFarInFuture(NoSuchEvent):
+    pass
+
+type Failure = NoSuchLeague | NoSuchEvent
+
+
+#######################################
+# Return Types For the Odds Tank      #
+#######################################
+
+
+@dataclass
+class NoSuchOddsAvailable:
+    event_id: int
+
+type NoResult = NoSuchLeague | NoSuchEvent | NoSuchOddsAvailable

ps3838api/models/fixtures.py

@@ -0,0 +1,53 @@
+# models/fixtures.py
+from typing import Required, TypedDict
+
+
+class FixtureV3(TypedDict, total=False):
+    """
+    Represents a single fixture within the API response.
+
+    - liveStatus: 0=no live, 1=live event, 2=will be offered live
+    - status: Deprecated; check period status in /odds
+    - betAcceptanceType: 0=none, 1=danger zone, 2=live delay, 3=both
+    - parlayRestriction: 0=full parlay allowed, 1=not allowed, 2=partial
+    """
+
+    id: Required[int]
+    parentId: int
+    starts: str  # date-time in UTC
+    home: str
+    away: str
+    rotNum: str  # Will be removed in future; see docs
+    liveStatus: int
+    homePitcher: str  # Baseball only
+    awayPitcher: str  # Baseball only
+    status: str  # "O", "H", or "I" (deprecated)
+    betAcceptanceType: int
+    parlayRestriction: int
+    altTeaser: bool
+    resultingUnit: str  # e.g. "corners", "bookings"
+    version: int  # fixture version changes with any update
+
+
+class FixturesLeagueV3(TypedDict):
+    """
+    Container for leagues in the Get Fixtures response.
+    """
+
+    id: int
+    name: str
+    events: list[FixtureV3]
+
+
+class FixturesResponse(TypedDict):
+    """
+    Full response for GET /v3/fixtures
+
+    - sportId: same as requested ID
+    - last: for delta updates (use as 'since' in next request)
+    """
+
+    sportId: int
+    last: int
+    league: list[FixturesLeagueV3]
+    """list of leagues"""

ps3838api/models/lines.py

@@ -0,0 +1,27 @@
+from typing import Literal, Required, TypedDict
+
+
+class LineResponse(TypedDict, total=False):
+    status: Required[Literal["SUCCESS", "NOT_EXISTS"]]
+
+    # The following fields are present only when status == "SUCCESS"
+    price: float
+    lineId: int
+    altLineId: int
+
+    team1Score: int
+    team2Score: int
+    team1RedCards: int
+    team2RedCards: int
+
+    maxRiskStake: float
+    minRiskStake: float
+    maxWinStake: float
+    minWinStake: float
+
+    effectiveAsOf: str
+
+    periodTeam1Score: int
+    periodTeam2Score: int
+    periodTeam1RedCards: int
+    periodTeam2RedCards: int

ps3838api/models/odds.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+from typing import TypedDict, Required, NotRequired
+
+
+# ─────────────────────────────────────────
+# Top-level structure of the response
+# ─────────────────────────────────────────
+class OddsResponse(TypedDict):
+    sportId: int
+    last: int  # Used for `since` in future incremental updates
+    leagues: list[OddsLeagueV3]
+
+
+# ─────────────────────────────────────────
+# League level
+# ─────────────────────────────────────────
+class OddsLeagueV3(TypedDict):
+    id: int
+    events: list[OddsEventV3]
+
+
+# ─────────────────────────────────────────
+# Event level
+# ─────────────────────────────────────────
+class OddsEventV3(TypedDict, total=False):
+    id: Required[int]
+    awayScore: float
+    homeScore: float
+    awayRedCards: int
+    homeRedCards: int
+    periods: list[OddsPeriodV3]
+
+
+# ─────────────────────────────────────────
+# Period level (e.g., full match, 1st half, etc.)
+# ─────────────────────────────────────────
+class OddsPeriodV3(TypedDict, total=False):
+    lineId: int
+    number: int  # 0 = full match, 1 = 1st half, etc.
+    cutoff: str  # ISO datetime string (UTC)
+    status: int  # 1 = online, 2 = offline
+
+    maxSpread: float
+    maxMoneyline: float
+    maxTotal: float
+    maxTeamTotal: float
+
+    moneylineUpdatedAt: str
+    spreadUpdatedAt: str
+    totalUpdatedAt: str
+    teamTotalUpdatedAt: str
+
+    spreads: list[OddsSpreadV3]
+    moneyline: OddsMoneylineV3
+    totals: list[OddsTotalV3]
+    teamTotal: OddsTeamTotalsV3
+
+    # Live stats at period level (Match and Extra Time only)
+    awayScore: float
+    homeScore: float
+    awayRedCards: int
+    homeRedCards: int
+
+
+# ─────────────────────────────────────────
+# Spread line data (handicap)
+# ─────────────────────────────────────────
+class OddsSpreadV3(TypedDict, total=False):
+    altLineId: int  # Present only for alternative lines
+    hdp: float  # Handicap
+    home: float  # Decimal odds for home team
+    away: float  # Decimal odds for away team
+    max: float  # Overrides `maxSpread` if present
+
+
+# ─────────────────────────────────────────
+# Moneyline data (1X2 market)
+# ─────────────────────────────────────────
+class OddsMoneylineV3(TypedDict, total=False):
+    home: float
+    away: float
+    draw: float  # Optional, only for sports/events with a draw
+
+
+# ─────────────────────────────────────────
+# Total Points line (Over/Under market)
+# ─────────────────────────────────────────
+class OddsTotalV3(TypedDict):
+    altLineId: NotRequired[int]  # Optional alternative line
+    points: float  # Total goals/points line
+    over: float  # Decimal odds for over
+    under: float  # Decimal odds for under
+    max: NotRequired[float]  # Overrides `maxTotal` if present
+
+
+# ─────────────────────────────────────────
+# Team Total Points (each team separately)
+# ─────────────────────────────────────────
+class OddsTeamTotalsV3(TypedDict, total=False):
+    home: OddsTeamTotalV3
+    away: OddsTeamTotalV3
+
+
+class OddsTeamTotalV3(TypedDict, total=False):
+    points: float  # Team-specific total line
+    over: float
+    under: float

ps3838api/models/tank.py

@@ -0,0 +1,5 @@
+from typing import TypedDict
+
+class EventInfo(TypedDict):
+    leagueId: int
+    eventId: int