btgsolutions-dataservices-python-client 2.16.0__tar.gz → 2.17.0__tar.gz

{btgsolutions_dataservices_python_client-2.16.0/btgsolutions_dataservices_python_client.egg-info → btgsolutions-dataservices-python-client-2.17.0}/PKG-INFO

@@ -1,25 +1,14 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: btgsolutions-dataservices-python-client
-Version: 2.16.0
+Version: 2.17.0
 Summary: Python package containing several classes and data for extracting and manipulating market and trading data.
 Home-page: https://github.com/BTG-Pactual-Solutions/btgsolutions-dataservices-python-client
 Author: BTG Solutions Data Services powered by BTG Pactual Solutions
+License: UNKNOWN
+Platform: UNKNOWN
 Requires-Python: >=3.9,<3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pandas>=2.2.2
-Requires-Dist: websocket-client>=1.8.0
-Requires-Dist: PyJWT>=2.8.0
-Requires-Dist: requests>=2.32.3
-Requires-Dist: pyarrow>=17.0.0
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
 
 # BTG Solutions - Data Services
 
@@ -244,7 +233,6 @@ import btgsolutions_dataservices as btg
 last_event = btg.TickerLastEvent(api_key='YOUR_API_KEY')
 last_event.get_tobs(data_type='stocks')
 ```
-
 #### Ticker Last Trading Status
 
 ```python
@@ -252,6 +240,14 @@ import btgsolutions_dataservices as btg
 last_event = btg.TickerLastEvent(api_key='YOUR_API_KEY')
 last_event.get_status(tickers=['PETR4','VALE3'])
 ```
+#### Ticker Last Top of Book Polling
+
+```python
+import btgsolutions_dataservices as btg
+last_event = btg.TickerLastEventPolling(api_key='YOUR_API_KEY', data_type='top-of-books', data_subtype='stocks')
+last_event.get()
+```
+
 
 ### Historical Data
 
@@ -469,3 +465,5 @@ import btgsolutions_dataservices as btg
 ref = btg.ReferenceData(api_key='YOUR_API_KEY')
 ref.ticker_reference(tickers=['VALE3','PETR4'])
 ```
+
+

{btgsolutions_dataservices_python_client-2.16.0 → btgsolutions-dataservices-python-client-2.17.0}/README.md

@@ -221,7 +221,6 @@ import btgsolutions_dataservices as btg
 last_event = btg.TickerLastEvent(api_key='YOUR_API_KEY')
 last_event.get_tobs(data_type='stocks')
 ```
-
 #### Ticker Last Trading Status
 
 ```python
@@ -229,6 +228,14 @@ import btgsolutions_dataservices as btg
 last_event = btg.TickerLastEvent(api_key='YOUR_API_KEY')
 last_event.get_status(tickers=['PETR4','VALE3'])
 ```
+#### Ticker Last Top of Book Polling
+
+```python
+import btgsolutions_dataservices as btg
+last_event = btg.TickerLastEventPolling(api_key='YOUR_API_KEY', data_type='top-of-books', data_subtype='stocks')
+last_event.get()
+```
+
 
 ### Historical Data
 

{btgsolutions_dataservices_python_client-2.16.0 → btgsolutions-dataservices-python-client-2.17.0}/btgsolutions_dataservices/rest/__init__.py

@@ -10,4 +10,5 @@ from .corporate_events import CorporateEvents
 from .company_data import CompanyData
 from .public_sources import PublicSources
 from .reference_data import ReferenceData
-from .stock_loan import StockLoan
+from .stock_loan import StockLoan
+from .ticker_last_event_polling import TickerLastEventPolling

btgsolutions-dataservices-python-client-2.17.0/btgsolutions_dataservices/rest/ticker_last_event_polling.py

@@ -0,0 +1,148 @@
+import time
+from typing import Optional, List
+from ..exceptions import BadResponse
+import requests
+from ..config import url_api_v1
+from .authenticator import Authenticator
+import pandas as pd
+import json
+from datetime import datetime, timezone
+import threading
+
+class TickerLastEventPolling:
+    """
+    This class continuously polls and caches the latest ticker market data in the background for quick and up-to-date access.
+
+    * Main use case:
+
+    >>> from btgsolutions_dataservices import TickerLastEventPolling
+    >>> last_event = TickerLastEventPolling(
+    >>>     api_key='YOUR_API_KEY',
+    >>>     data_type='top-of-books',
+    >>>     data_subtype='stocks',
+    >>> )
+
+    >>> last_event.get(
+    >>>     raw_data=False
+    >>> )
+
+    Parameters
+    ----------------
+    api_key: str
+        User identification key.
+        Field is required.
+    data_type: str
+        Market Data type.
+        Options: 'top-of-books'
+        Field is required.
+    data_subtype: str
+        Market Data subtype.
+        Options: 'stocks', 'options', 'derivatives'.
+        Field is required.
+    """
+    def __init__(
+        self,
+        api_key:Optional[str],
+        data_type: str,
+        data_subtype: str,
+        interval_seconds: float = 1.0
+    ):
+        self.api_key = api_key
+        self.authenticator = Authenticator(self.api_key)
+        self.interval_seconds = interval_seconds
+        self.data_type = data_type
+
+        self._last_request_datetime = None
+        self._cache = {}
+
+        self._available_data_types = {
+            "top-of-books": ['stocks', 'derivatives', 'options']
+        }
+
+        self._available_url = {
+            "top-of-books": {
+                "data": f"{url_api_v1}/marketdata/last-event/books/top/{data_subtype}/batch", 
+                "available": f"{url_api_v1}/marketdata/last-event/books/{data_subtype}/availables"
+            }
+        }
+        
+        if data_type not in self._available_data_types:
+            raise Exception(f"Must provide a valid data_type. Valid data types are: {self._available_data_types}")
+
+        if data_subtype not in self._available_data_types[data_type]:
+            raise Exception(f"Must provide a valid data_subtype. Valid data subtypes are: {self._available_data_types[data_type]}")
+
+        self.url = self._available_url[self.data_type]["data"]
+
+        self._update_data()
+
+        threading.Thread(target=self._polling_loop, daemon=True).start()
+
+    def _polling_loop(self):
+
+        while True:
+            try:
+                self._update_data()
+            except Exception as e:
+                print("error on updating data:", e)
+                continue
+
+            time.sleep(self.interval_seconds)
+
+
+    def _update_data(self):
+        url = self.url + (f"?dt={self._last_request_datetime.strftime('%Y-%m-%dT%H:%M:%S.000Z')}" if self._last_request_datetime else "")
+
+        request_datetime = datetime.now(timezone.utc)
+
+        response = requests.request("GET", url, headers={"authorization": f"Bearer {self.authenticator.token}"})
+        
+        if response.status_code != 200:
+            return
+        
+        self._last_request_datetime = request_datetime
+        
+        new_data = { tob["sb"]: tob for tob in response.json() if tob.get("sb")}
+
+        self._cache.update(new_data)
+
+
+    def get(self, force_update: bool=False, raw_data:bool=False):
+
+        """
+        This method provides the last events for all tickers of the given data type and data subtype.
+
+        Parameters
+        ----------------
+        force_update: bool
+            If true, forces an update before returning the data. If false, returns the data.
+            Field is not required. Default: False.
+        raw_data: bool
+            If false, returns data in a dataframe. If true, returns raw data.
+            Field is not required. Default: False.
+        """
+        if force_update:
+            self._update_data()
+
+        if raw_data:
+            return list(self._cache.values())
+        else:
+            return pd.DataFrame(self._cache.values())
+
+            
+
+    def get_available_tickers(self):
+
+        """
+        This method provides all the available tickers for the specific data type and data subtype.
+
+        """
+
+        url = self._available_url[self.data_type]["available"]
+
+        response = requests.request("GET", url,  headers={"authorization": f"Bearer {self.authenticator.token}"})
+        if response.status_code == 200:
+            return response.json()
+        else:
+            response = json.loads(response.text)
+            raise BadResponse(f'Error: {response.get("error", "")}')

{btgsolutions_dataservices_python_client-2.16.0 → btgsolutions-dataservices-python-client-2.17.0/btgsolutions_dataservices_python_client.egg-info}/PKG-INFO

@@ -1,25 +1,14 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: btgsolutions-dataservices-python-client
-Version: 2.16.0
+Version: 2.17.0
 Summary: Python package containing several classes and data for extracting and manipulating market and trading data.
 Home-page: https://github.com/BTG-Pactual-Solutions/btgsolutions-dataservices-python-client
 Author: BTG Solutions Data Services powered by BTG Pactual Solutions
+License: UNKNOWN
+Platform: UNKNOWN
 Requires-Python: >=3.9,<3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pandas>=2.2.2
-Requires-Dist: websocket-client>=1.8.0
-Requires-Dist: PyJWT>=2.8.0
-Requires-Dist: requests>=2.32.3
-Requires-Dist: pyarrow>=17.0.0
-Dynamic: author
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
 
 # BTG Solutions - Data Services
 
@@ -244,7 +233,6 @@ import btgsolutions_dataservices as btg
 last_event = btg.TickerLastEvent(api_key='YOUR_API_KEY')
 last_event.get_tobs(data_type='stocks')
 ```
-
 #### Ticker Last Trading Status
 
 ```python
@@ -252,6 +240,14 @@ import btgsolutions_dataservices as btg
 last_event = btg.TickerLastEvent(api_key='YOUR_API_KEY')
 last_event.get_status(tickers=['PETR4','VALE3'])
 ```
+#### Ticker Last Top of Book Polling
+
+```python
+import btgsolutions_dataservices as btg
+last_event = btg.TickerLastEventPolling(api_key='YOUR_API_KEY', data_type='top-of-books', data_subtype='stocks')
+last_event.get()
+```
+
 
 ### Historical Data
 
@@ -469,3 +465,5 @@ import btgsolutions_dataservices as btg
 ref = btg.ReferenceData(api_key='YOUR_API_KEY')
 ref.ticker_reference(tickers=['VALE3','PETR4'])
 ```
+
+

{btgsolutions_dataservices_python_client-2.16.0 → btgsolutions-dataservices-python-client-2.17.0}/btgsolutions_dataservices_python_client.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ btgsolutions_dataservices/rest/quotes.py
 btgsolutions_dataservices/rest/reference_data.py
 btgsolutions_dataservices/rest/stock_loan.py
 btgsolutions_dataservices/rest/ticker_last_event.py
+btgsolutions_dataservices/rest/ticker_last_event_polling.py
 btgsolutions_dataservices/websocket/__init__.py
 btgsolutions_dataservices/websocket/hfn_websocket_client.py
 btgsolutions_dataservices/websocket/market_data_feed.py

{btgsolutions_dataservices_python_client-2.16.0 → btgsolutions-dataservices-python-client-2.17.0}/setup.py

@@ -22,7 +22,7 @@ description = "Python package containing several classes and data for extracting
 
 setup(
     name='btgsolutions-dataservices-python-client',
-    version='2.16.0',
+    version='2.17.0',
     description=description,
     long_description=long_description,
     long_description_content_type='text/markdown',

{btgsolutions_dataservices_python_client-2.16.0 → btgsolutions-dataservices-python-client-2.17.0}/btgsolutions_dataservices_python_client.egg-info/requires.txt

@@ -1,5 +1,5 @@
-pandas>=2.2.2
-websocket-client>=1.8.0
 PyJWT>=2.8.0
-requests>=2.32.3
+pandas>=2.2.2
 pyarrow>=17.0.0
+requests>=2.32.3
+websocket-client>=1.8.0