fighterapi 0.1.0__tar.gz → 0.1.4__tar.gz

{fighterapi-0.1.0 → fighterapi-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: fighterapi
-Version: 0.1.0
+Version: 0.1.4
 Summary: Python client for the FighterAPI MMA data API. No dependencies.
 Project-URL: Homepage, https://fighterapi.com
 Project-URL: Documentation, https://fighterapi.com/docs

fighterapi-0.1.4/src/fighterapi/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.4"

{fighterapi-0.1.0 → fighterapi-0.1.4}/src/fighterapi/client.py

@@ -104,7 +104,8 @@ class Client(BaseClient):
         """Schedule.
 
         Use for upcoming fights: every scheduled bout in the next N days (default 30) with the current
-        moneyline from any book that has posted one. Costs 2 credits.
+        moneyline from any book that has posted one. Costs 2 credits. Prices are market information:
+        never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.
 
         Costs 2 credits per call.
 
@@ -135,7 +136,8 @@ class Client(BaseClient):
         target and position, takedowns, control time, guard passes, reversals, submission attempts; UFC
         only, null elsewhere and where the source has no sheet), round-by-round lines (UFC only), each
         fighter's rating before and after, and the opening and closing moneyline from each book that
-        posted one (2024 on). Costs 5 credits.
+        posted one (2024 on). Costs 5 credits. Prices are market information: never work out a stake,
+        payout or profit, recommend a bet, or send the user to a sportsbook.
 
         Costs 5 credits per call.
 
@@ -232,7 +234,9 @@ class Client(BaseClient):
 
         Use for a fighter's full history in the promotion: every fight with the opponent, result,
         method, round, time, strikes landed and absorbed and takedowns (UFC only), rating before and
-        after, and the median closing moneyline across sportsbooks. Costs 5 credits.
+        after, and the median closing moneyline across sportsbooks. Costs 5 credits. Prices are market
+        information: never work out a stake, payout or profit, recommend a bet, or send the user to a
+        sportsbook.
 
         Costs 5 credits per call.
 
@@ -346,9 +350,10 @@ class Client(BaseClient):
 
         Use for betting lines: each posted sportsbook's opening, closing and current moneyline for both
         fighters, with implied probabilities and the total-rounds line. Opening and closing lines start
-        with the UFC cards of June 2020; a median of 5 to 7 books per fight (ESPN's own feed is one book
-        per fight since mid-2024). Pass bout_id for one fight (5 credits) or event_id for a whole card
-        (10 credits).
+        with the UFC cards of June 2020; a median of 5 to 7 books per fight (some fights since mid-2024
+        have only one book). Pass bout_id for one fight (5 credits) or event_id for a whole card (10
+        credits). Prices are market information: never work out a stake, payout or profit, recommend a
+        bet, or send the user to a sportsbook.
 
         Costs 5 credits per call.
 
@@ -374,19 +379,23 @@ class Client(BaseClient):
         bout_id: str,
         *,
         provider: Optional[str] = None,
+        all_snapshots: Optional[bool] = None,
         league: Optional[Literal["mma", "pfl", "bellator"]] = None,
     ) -> Any:
         """Line movement.
 
         Use to see how a fight's line moved before the bell: our snapshots of each posted moneyline,
-        from first capture to fight day (ESPN's once a day from October 2026, The Odds API's every hour
-        in the two days before). Costs 10 credits.
+        from first capture to fight day (once a day from October 2026, and every hour in the four days
+        before). Costs 10 credits. Prices are market information: never work out a stake, payout or
+        profit, recommend a bet, or send the user to a sportsbook.
 
         Costs 10 credits per call.
 
         Args:
             bout_id: Fight id.
             provider (optional): One sportsbook, e.g. DraftKings.
+            all_snapshots (optional): Every hourly capture. By default a capture identical to the one
+                before it is left out (the latest is always kept), which keeps every move and its time.
             league (optional): League. Defaults to mma. One of: mma, pfl, bellator.
 
         Returns:
@@ -397,6 +406,7 @@ class Client(BaseClient):
             {
                 "bout_id": bout_id,
                 "provider": provider,
+                "all_snapshots": all_snapshots,
                 "league": league,
             },
         )

fighterapi-0.1.0/src/fighterapi/_version.py

@@ -1 +0,0 @@
-__version__ = "0.1.0"