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

{btgsolutions-dataservices-python-client-2.17.0 → btgsolutions_dataservices_python_client-2.18.0}/PKG-INFO

@@ -1,11 +1,9 @@
 Metadata-Version: 2.1
-Name: btgsolutions-dataservices-python-client
-Version: 2.17.0
+Name: btgsolutions_dataservices_python_client
+Version: 2.18.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
@@ -13,6 +11,7 @@ License-File: LICENSE
 # BTG Solutions - Data Services
 
 Real time and historical Financial Market Data, News, Corporate Events and more.
+More information at https://dataservices.btgpactualsolutions.com/.
 
 ## Installation
 
@@ -233,6 +232,7 @@ 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
@@ -240,7 +240,8 @@ 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
+
+#### Ticker Last Polling - Top of Books
 
 ```python
 import btgsolutions_dataservices as btg
@@ -466,4 +467,3 @@ ref = btg.ReferenceData(api_key='YOUR_API_KEY')
 ref.ticker_reference(tickers=['VALE3','PETR4'])
 ```
 
-

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

@@ -1,6 +1,7 @@
 # BTG Solutions - Data Services
 
 Real time and historical Financial Market Data, News, Corporate Events and more.
+More information at https://dataservices.btgpactualsolutions.com/.
 
 ## Installation
 
@@ -221,6 +222,7 @@ 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
@@ -228,7 +230,8 @@ 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
+
+#### Ticker Last Polling - Top of Books
 
 ```python
 import btgsolutions_dataservices as btg
@@ -453,3 +456,4 @@ import btgsolutions_dataservices as btg
 ref = btg.ReferenceData(api_key='YOUR_API_KEY')
 ref.ticker_reference(tickers=['VALE3','PETR4'])
 ```
+

{btgsolutions-dataservices-python-client-2.17.0 → btgsolutions_dataservices_python_client-2.18.0}/btgsolutions_dataservices/rest/ticker_last_event_polling.py

@@ -6,7 +6,7 @@ from ..config import url_api_v1
 from .authenticator import Authenticator
 import pandas as pd
 import json
-from datetime import datetime, timezone
+from datetime import datetime, timezone, timedelta
 import threading
 
 class TickerLastEventPolling:
@@ -33,11 +33,11 @@ class TickerLastEventPolling:
         Field is required.
     data_type: str
         Market Data type.
-        Options: 'top-of-books'
+        Options: 'top-of-books', 'snapshot-tob'.
         Field is required.
     data_subtype: str
         Market Data subtype.
-        Options: 'stocks', 'options', 'derivatives'.
+        Options: 'stocks', 'options', 'derivatives', 'equities'.
         Field is required.
     """
     def __init__(
@@ -45,24 +45,33 @@ class TickerLastEventPolling:
         api_key:Optional[str],
         data_type: str,
         data_subtype: str,
-        interval_seconds: float = 1.0
+        interval_seconds: Optional[float]=None
     ):
         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']
+            "top-of-books": ['stocks', 'derivatives', 'options'],
+            "snapshot-tob": ['equities', 'derivatives']
+        }
+
+        self._default_interval_seconds  = {
+            "top-of-books": 1,
+            "snapshot-tob": 10
         }
 
         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"
+            },
+            "snapshot-tob": {
+                "data": f"{url_api_v1}/marketdata/br/b3/snapshot/book/tob/{data_subtype}/batch", 
+                "available": f"{url_api_v1}/marketdata/br/b3/snapshot/book/tob/{data_subtype}/available-tickers"
             }
         }
         
@@ -72,6 +81,12 @@ class TickerLastEventPolling:
         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]}")
 
+
+        if interval_seconds is None:
+            self.interval_seconds = self._default_interval_seconds[data_type]
+        else:
+            self.interval_seconds = interval_seconds
+
         self.url = self._available_url[self.data_type]["data"]
 
         self._update_data()
@@ -91,15 +106,16 @@ class TickerLastEventPolling:
 
 
     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 "")
+        url = self.url + (f"?dt={(self._last_request_datetime - timedelta(seconds=60)).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")}

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

@@ -1,11 +1,9 @@
 Metadata-Version: 2.1
 Name: btgsolutions-dataservices-python-client
-Version: 2.17.0
+Version: 2.18.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
@@ -13,6 +11,7 @@ License-File: LICENSE
 # BTG Solutions - Data Services
 
 Real time and historical Financial Market Data, News, Corporate Events and more.
+More information at https://dataservices.btgpactualsolutions.com/.
 
 ## Installation
 
@@ -233,6 +232,7 @@ 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
@@ -240,7 +240,8 @@ 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
+
+#### Ticker Last Polling - Top of Books
 
 ```python
 import btgsolutions_dataservices as btg
@@ -466,4 +467,3 @@ ref = btg.ReferenceData(api_key='YOUR_API_KEY')
 ref.ticker_reference(tickers=['VALE3','PETR4'])
 ```
 
-

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

@@ -21,8 +21,8 @@ else:
 description = "Python package containing several classes and data for extracting and manipulating market and trading data."
 
 setup(
-    name='btgsolutions-dataservices-python-client',
-    version='2.17.0',
+    name='btgsolutions_dataservices_python_client',
+    version='2.18.0',
     description=description,
     long_description=long_description,
     long_description_content_type='text/markdown',

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

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