ps3838api 1.1.0__py3-none-any.whl

ps3838api/models/bets.py

@@ -0,0 +1,250 @@
+from typing import Literal, NotRequired, TypedDict
+
+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 BetList = Literal["SETTLED", "RUNNING", "ALL"]
+
+type SortDir = Literal["ASC", "DESC"]
+
+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]
+
+
+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/client.py

@@ -0,0 +1,48 @@
+from typing import Literal, NotRequired, TypedDict
+
+
+class BalanceData(TypedDict):
+    availableBalance: float
+    outstandingTransactions: float
+    givenCredit: float
+    currency: str
+
+
+class PeriodData(TypedDict, total=False):
+    number: NotRequired[int]
+    description: NotRequired[str]
+    shortDescription: NotRequired[str]
+    spreadDescription: NotRequired[str]
+    moneylineDescription: NotRequired[str]
+    totalDescription: NotRequired[str]
+    team1TotalDescription: NotRequired[str]
+    team2TotalDescription: NotRequired[str]
+    spreadShortDescription: NotRequired[str]
+    moneylineShortDescription: NotRequired[str]
+    totalShortDescription: NotRequired[str]
+    team1TotalShortDescription: NotRequired[str]
+    team2TotalShortDescription: NotRequired[str]
+
+
+class LeagueV3(TypedDict):
+    id: int
+    name: str
+    homeTeamType: NotRequired[str]
+    hasOfferings: NotRequired[bool]
+    container: NotRequired[str]
+    allowRoundRobins: NotRequired[bool]
+    leagueSpecialsCount: NotRequired[int]
+    eventSpecialsCount: NotRequired[int]
+    eventCount: NotRequired[int]
+
+
+class BettingStatusResponse(TypedDict):
+    status: Literal["ALL_BETTING_ENABLED", "ALL_LIVE_BETTING_CLOSED", "ALL_BETTING_CLOSED"]
+
+
+__all__ = [
+    "BalanceData",
+    "PeriodData",
+    "LeagueV3",
+    "BettingStatusResponse",
+]

ps3838api/models/errors.py

@@ -0,0 +1,43 @@
+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,61 @@
+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: Required[str]
+    away: Required[str]
+    rotNum: str  # Will be removed in future; see docs
+    liveStatus: Required[int]
+    homePitcher: str  # Baseball only
+    awayPitcher: str  # Baseball only
+    status: str  # "O", "H", or "I" (deprecated)
+    betAcceptanceType: int
+    parlayRestriction: int
+    altTeaser: bool
+    resultingUnit: Required[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,221 @@
+from __future__ import annotations
+
+from typing import NotRequired, Required, TypedDict
+
+
+# ─────────────────────────────────────────
+# Top-level structure of the response (V3)
+# ─────────────────────────────────────────
+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
+
+
+# ═════════════════════════════════════════════════════════════════════════════
+# V4 Odds Models
+# ═════════════════════════════════════════════════════════════════════════════
+
+
+# ─────────────────────────────────────────
+# V4 Top-level response structure
+# ─────────────────────────────────────────
+class OddsResponseV4(TypedDict):
+    sportId: int
+    last: int  # Used for `since` in future incremental updates
+    leagues: list[OddsLeagueV4]
+
+
+# ─────────────────────────────────────────
+# V4 League level
+# ─────────────────────────────────────────
+class OddsLeagueV4(TypedDict):
+    id: int
+    events: list[OddsEventV4]
+
+
+# ─────────────────────────────────────────
+# V4 Event level
+# ─────────────────────────────────────────
+class OddsEventV4(TypedDict, total=False):
+    id: Required[int]
+    awayScore: float
+    homeScore: float
+    awayRedCards: int
+    homeRedCards: int
+    periods: list[OddsPeriodV4]
+
+
+# ─────────────────────────────────────────
+# V4 Period level
+# ─────────────────────────────────────────
+class OddsPeriodV4(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[OddsSpreadV4]
+    moneyline: OddsMoneylineV4
+    totals: list[OddsTotalV4]
+    teamTotal: OddsTeamTotalsV4
+
+    # Live stats at period level (Match and Extra Time only)
+    awayScore: float
+    homeScore: float
+    awayRedCards: int
+    homeRedCards: int
+
+
+# ─────────────────────────────────────────
+# V4 Spread line data (handicap)
+# ─────────────────────────────────────────
+class OddsSpreadV4(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
+
+
+# ─────────────────────────────────────────
+# V4 Moneyline data (1X2 market)
+# ─────────────────────────────────────────
+class OddsMoneylineV4(TypedDict, total=False):
+    home: float
+    away: float
+    draw: float  # Optional, only for sports/events with a draw
+
+
+# ─────────────────────────────────────────
+# V4 Total Points line (Over/Under market)
+# ─────────────────────────────────────────
+class OddsTotalV4(TypedDict, total=False):
+    altLineId: int  # Optional alternative line
+    points: Required[float]  # Total goals/points line
+    over: Required[float]  # Decimal odds for over
+    under: Required[float]  # Decimal odds for under
+    max: float  # Overrides `maxTotal` if present
+
+
+# ─────────────────────────────────────────
+# V4 Team Total Points (each team separately)
+# Key difference from V3: arrays instead of single objects
+# ─────────────────────────────────────────
+class OddsTeamTotalsV4(TypedDict, total=False):
+    home: list[OddsTeamTotalV4]
+    away: list[OddsTeamTotalV4]
+
+
+class OddsTeamTotalV4(TypedDict, total=False):
+    points: Required[float]  # Team-specific total line
+    over: Required[float]
+    under: Required[float]
+    altLineId: int  # Present only for alternative lines
+    max: float  # Maximum bet volume for alternative lines