ps3838api 1.1.0__py3-none-any.whl

ps3838api-1.1.0.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: ps3838api
+Version: 1.1.0
+Summary: A lightweight Python library to interact with the Pinnacle API (PS3838, Pinnacle888 etc.) and place bets.
+Author-email: Ilias Dzhabbarov <ilias.dzabbarov@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/iliyasone/ps3838api
+Project-URL: Issues, https://github.com/iliyasone/ps3838api/issues
+Keywords: ps3838,sports betting,api,pinnacle,odds,python
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rapidfuzz>=3.14.3
+Requires-Dist: requests>=2.32.5
+Dynamic: license-file
+
+# Modern PS3838 API
+
+A lightweight Python library to interact with the PS3838 (Pinnacle) API and place bets.
+
+## 🔑 Key Idea
+
+This project aims to keep all method names and behavior as close as possible to the official [PS3838 API documentation](https://ps3838api.github.io/docs/). No abstraction layers that get in your way — just a clean, Pythonic functional interface to the raw API.
+
+If you need assistance, contact me directly on Telegram: [@iliyasone](https://t.me/iliyasone) 💬
+
+If you have any questions or need additional tools, join Betting API PS3838 & Pinnacle Telegram Group Chat: [@ps3838api](https://t.me/ps3838api/77/78) 
+
+If you don’t have access to the PS3838 API (Pinnacle) yet, feel free to reach out — I can help you get started with obtaining access.
+
+## ✨ Features
+
+### `ps3838api.api` — Minimalist, Typed API Wrapper
+
+- **PinnacleClient-First:** Instantiate `ps3838api.api.client.PinnacleClient` with credentials supplied via environment variables and call methods directly. Legacy module-level helpers still work for backwards compatibility, but marked as deprecated.
+- **Type-Safe:** Responses are structured using precise `TypedDict` definitions based directly on the official docs.
+- **Clean Data:** Say goodbye to messy, undocumented JSON blobs.
+- **Lightweight:** No bloated ORMs or clunky third-party wrappers — just clean, readable code.
+
+### Bet Placement
+
+- Place bets with simple functions that eliminate unnecessary overhead.
+
+## 🚀 Setup
+
+> You can also check out the [📓 examples.ipynb](https://github.com/iliyasone/ps3838api/blob/release/1.0.1/examples/examples.ipynb) for a quick start!
+
+This project has been created and tested on the Python 3.13.7, however it should work also on Python>=3.12
+
+### 1. Create PinnacleClient
+
+```python
+from ps3838api.api.client import PinnacleClient
+from ps3838api.models.sports import Sport
+
+client = PinnacleClient(
+    login='YOUR_LOGIN',
+    password='YOUR_PASSWORD',
+    api_base_url='https://api.ps3838.com', # default
+    default_sport=Sport.SOCCER_SPORT_ID # default
+)
+```
+
+`PinnacleClient` could also use `PS3838_LOGIN`, `PS3838_PASSWORD` environment variables.
+It is also possible to change default `PS3838_API_BASE_URL` from https://api.ps3838.com/ to a different Pinnacle mirror
+
+> Pinnacle888 is yet another one popular Pinnacle mirror, and its documentation and endpoints are identical to the PS3838  
+>
+> Docs: https://pinny888.github.io/  
+>
+> API Base URL: https://api.pinnacle888.com  
+
+### 2. Check PinnacleClient Balance
+
+Quickly check your account balance by calling the API:
+
+```python
+from ps3838api.api.client import PinnacleClient
+
+client = PinnacleClient()
+balance = client.get_client_balance()
+print("PinnacleClient Balance:", balance)
+```
+
+Expected output:
+
+```json
+{
+    "availableBalance": 200.0,
+    "outstandingTransactions": 0.0,
+    "givenCredit": 0.0,
+    "currency": "USD"
+}
+```
+
+## 🎯 Retrieve Events and Fixtures Place Bet
+
+Find and use events with ease:
+
+```python
+fixtures = client.get_fixtures()
+odds = client.get_odds()
+```
+
+Using fixtures and odds, find events according to the method interfaces and [official Pinnacle API Response schemas](https://ps3838api.github.io/docs/#tag/Odds/operation/Odds_Straight_V3_Get)
+
+### V4 API Endpoints
+
+For enhanced odds responses with alternative team total lines, use the V4 client:
+
+```python
+# Get V4 odds with array-based team totals
+v4_odds = client.v4.get_odds(sport_id=1)
+
+# Get V4 parlay odds
+v4_parlay_odds = client.v4.get_parlay_odds(sport_id=1)
+```
+
+V4 endpoints provide the same parameters as V3 but return enhanced response structures where team totals are arrays, allowing multiple alternative lines per team.
+
+> note: in a future version the package will include `magic_find_event` function which would make finding events more
+straightforward 
+
+## 💸 Place a Bet
+
+Once you have your event and total line, place your bet:
+
+```python
+event_id: int
+line_id: int
+alt_line_id: int | None 
+total_line_points: float
+
+stake_usdt = 1.0
+
+place_bet_response = client.place_straight_bet(
+    stake=stake_usdt,
+    event_id=event['eventId'],
+    bet_type='TOTAL_POINTS',
+    line_id=total_line.get('lineId', None),
+    alt_line_id=total_line.get('altLineId', None),
+    side='OVER',
+    handicap=total_line['points']
+)
+print("Unique Request ID:", place_bet_response['uniqueRequestId'])
+```
+
+You can also check your bet status:
+
+```python
+bets = client.get_bets(unique_request_ids=[place_bet_response['uniqueRequestId']])
+# Verify the bet status
+```
+
+## 🛠️ Local Installation
+
+To install the library locally, install `uv` and run the following commands:
+
+```bash
+git clone https://github.com/iliyasone/ps3838api.git
+cd ps3838api
+uv sync --all-groups
+```
+
+## Run checkers
+
+```bash
+uv run ruff check
+uv run ruff format
+uv run pyright
+```
+
+Happy coding

ps3838api-1.1.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+ps3838api/__init__.py,sha256=uKk_wbA5NMb_YDjUapMmQw4b0g09HquFlQHgMcS2dnI,192
+ps3838api/matching.py,sha256=oRloXgk2DzMiiPYskTWFAEH34C2sAUsWbnyxTQNLJew,4794
+ps3838api/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ps3838api/tank.py,sha256=wQDAiw6F9ywUoDXdvzuRCxgqvp2NO0_JLR8uY9qJSuM,3546
+ps3838api/totals.py,sha256=NmQjfQcaARJV1SGkGuGMjNJ5UX1t7OBezY7JMBT50uc,1690
+ps3838api/api/__init__.py,sha256=pXLOXGLDoZ-zOBo0wA62AsRAq9yZ3PlkV-zFyXSTFis,1557
+ps3838api/api/client.py,sha256=I4G7hFbZufum0GKj36_uAN61BKz1sWEOv5kDAJVUzxs,19323
+ps3838api/api/default_client.py,sha256=MK9HGit4GXSpO09jpUxnzngoWw06cg80Jt6nsLBt39c,6811
+ps3838api/api/v4client.py,sha256=FOIl2cJ6IIGJrYVAEqd8cWz_lnoIkcsrIrvRmCIQQ4A,3982
+ps3838api/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ps3838api/models/bets.py,sha256=CSxfl4pRjac_WbRoxdYiPGE9cwAFmbDANMIfHjmN6hw,6511
+ps3838api/models/client.py,sha256=8v6H6pBjOA9_zCZAQXOaMzPL-lo4VtCst1GYCmsbcFo,1324
+ps3838api/models/errors.py,sha256=EM2ZpuvmrXpI3scQdkC1FBohrwKRQsAqKGitsN-9g7o,877
+ps3838api/models/event.py,sha256=9uj1jHaY-krf4bF-npqrjdEsCcXcw9W58YNUithQLU0,960
+ps3838api/models/fixtures.py,sha256=GMvpRHaqN24jud3wAmVGRrLghWBlZfI2y38WUpxdSwY,1421
+ps3838api/models/lines.py,sha256=7MYbhv1Qnrfna7SvpDJTF8p4GY12iQH_P2l6hzp_7Cg,588
+ps3838api/models/odds.py,sha256=kpu2gEqQQk_DZmgf3aaR-uvgd1Ez7LuRpb9Fp7gLsgE,9376
+ps3838api/models/sports.py,sha256=4-39JvsOyk34peXnnuiGV5a26rHNjgube8k0vHp5af0,8748
+ps3838api/models/tank.py,sha256=hyrhWC2NHzkDhJioXEz2XENTSbCm0VihDRbcUF7LsA0,94
+ps3838api/utils/match_leagues.py,sha256=tcJUc2TkMMhR8jtwLzvnDtSlp2V3cixnc85K4WpTtwE,3490
+ps3838api/utils/ops.py,sha256=rfvU2BKQJM5jwI32tXcfLuyYaXGFYXOnZKqgNqAFPzk,5606
+ps3838api-1.1.0.dist-info/licenses/LICENSE,sha256=h3bmeb_pl9XMAwVOrS4n7f0umjAj2Kwx2jcwYlCfBU0,1065
+ps3838api-1.1.0.dist-info/METADATA,sha256=BHnA7pis2StCNG3yirrpQV59d-ClhACLB9SEOVBWZNE,5581
+ps3838api-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ps3838api-1.1.0.dist-info/top_level.txt,sha256=ec8CzKfcDq10-rMF_IM-9kxxxlnT4euiLfVrwQrmO0s,10
+ps3838api-1.1.0.dist-info/RECORD,,

ps3838api-1.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ps3838api-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,8 @@
+Copyright 2025 Ilias Dzhabbarov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

ps3838api-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ps3838api