btgsolutions-dataservices-python-client 3.3.0__tar.gz → 4.0.0__tar.gz

{btgsolutions_dataservices_python_client-3.3.0/btgsolutions_dataservices_python_client.egg-info → btgsolutions_dataservices_python_client-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: btgsolutions_dataservices_python_client
-Version: 3.3.0
+Version: 4.0.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
@@ -383,28 +383,7 @@ bulk_data.get_compressed_data(channel='98', date='2026-01-30', data_type='instru
 
 ```python
 import btgsolutions_dataservices as btg
-ws = btg.HFNWebSocketClient(api_key='YOUR_API_KEY', country='brazil')
-ws.run(on_message=lambda message: print(message))
-
-## The following is optional to keep the program running in a .py file:
-# from time import sleep
-# while True:
-#   sleep(1)
-```
-
-#### High Frequency News
-
-```python
-import btgsolutions_dataservices as btg
-hfn = btg.HighFrequencyNews(api_key='YOUR_API_KEY')
-hfn.latest_news()
-```
-
-#### High Frequency News V3 Stream
-
-```python
-import btgsolutions_dataservices as btg
-ws = btg.HFNV3WebSocketClient(api_key='YOUR_API_KEY')
+ws = btg.HFNWebSocketClient(api_key='YOUR_API_KEY')
 ws.run(on_message=lambda message: print(message))
 
 # Subscribe to live economy news in Portuguese
@@ -420,13 +399,18 @@ ws.available_filters(settings={})
 ws.unsubscribe()
 
 ws.close()
+
+## The following is optional to keep the program running in a .py file:
+# from time import sleep
+# while True:
+#   sleep(1)
 ```
 
-#### High Frequency News V3
+#### High Frequency News
 
 ```python
 import btgsolutions_dataservices as btg
-hfn = btg.HighFrequencyNewsV3(api_key='YOUR_API_KEY')
+hfn = btg.HighFrequencyNews(api_key='YOUR_API_KEY')
 
 # Latest news with filters
 hfn.get_latest_news(feed='economy', text_language='portuguese', limit=10)
@@ -437,7 +421,7 @@ hfn.get_latest_news(tags=['PETR4', 'VALE3'])
 # Historical news for a date range
 hfn.get_historical_news(
     start_date='2026-05-01T00:00:00.000Z',
-    end_date='2026-05-01T23:59:59.999Z',
+    end_date='2026-05-08T23:59:59.999Z',
     feed='economy',
 )
 

{btgsolutions_dataservices_python_client-3.3.0 → btgsolutions_dataservices_python_client-4.0.0}/README.md

@@ -360,28 +360,7 @@ bulk_data.get_compressed_data(channel='98', date='2026-01-30', data_type='instru
 
 ```python
 import btgsolutions_dataservices as btg
-ws = btg.HFNWebSocketClient(api_key='YOUR_API_KEY', country='brazil')
-ws.run(on_message=lambda message: print(message))
-
-## The following is optional to keep the program running in a .py file:
-# from time import sleep
-# while True:
-#   sleep(1)
-```
-
-#### High Frequency News
-
-```python
-import btgsolutions_dataservices as btg
-hfn = btg.HighFrequencyNews(api_key='YOUR_API_KEY')
-hfn.latest_news()
-```
-
-#### High Frequency News V3 Stream
-
-```python
-import btgsolutions_dataservices as btg
-ws = btg.HFNV3WebSocketClient(api_key='YOUR_API_KEY')
+ws = btg.HFNWebSocketClient(api_key='YOUR_API_KEY')
 ws.run(on_message=lambda message: print(message))
 
 # Subscribe to live economy news in Portuguese
@@ -397,13 +376,18 @@ ws.available_filters(settings={})
 ws.unsubscribe()
 
 ws.close()
+
+## The following is optional to keep the program running in a .py file:
+# from time import sleep
+# while True:
+#   sleep(1)
 ```
 
-#### High Frequency News V3
+#### High Frequency News
 
 ```python
 import btgsolutions_dataservices as btg
-hfn = btg.HighFrequencyNewsV3(api_key='YOUR_API_KEY')
+hfn = btg.HighFrequencyNews(api_key='YOUR_API_KEY')
 
 # Latest news with filters
 hfn.get_latest_news(feed='economy', text_language='portuguese', limit=10)
@@ -414,7 +398,7 @@ hfn.get_latest_news(tags=['PETR4', 'VALE3'])
 # Historical news for a date range
 hfn.get_historical_news(
     start_date='2026-05-01T00:00:00.000Z',
-    end_date='2026-05-01T23:59:59.999Z',
+    end_date='2026-05-08T23:59:59.999Z',
     feed='economy',
 )
 

{btgsolutions_dataservices_python_client-3.3.0 → btgsolutions_dataservices_python_client-4.0.0}/btgsolutions_dataservices/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "3.3.0"
+__version__ = "4.0.0"
 
 from .websocket import *
 from .rest import *

{btgsolutions_dataservices_python_client-3.3.0 → btgsolutions_dataservices_python_client-4.0.0}/btgsolutions_dataservices/rest/__init__.py

@@ -4,7 +4,6 @@ from .historical_candles_crypto import HistoricalCandlesCrypto
 from .authenticator import Authenticator
 from .bulk_data import BulkData
 from .hfn import HighFrequencyNews
-from .hfn_v3 import HighFrequencyNewsV3
 from .quotes import Quotes
 from .intraday_tick_data import IntradayTickData
 from .ticker_last_event import TickerLastEvent

btgsolutions_dataservices_python_client-3.3.0/btgsolutions_dataservices/rest/hfn_v3.py → btgsolutions_dataservices_python_client-4.0.0/btgsolutions_dataservices/rest/hfn.py

@@ -8,16 +8,16 @@ import pandas as pd
 from .authenticator import Authenticator
 
 
-class HighFrequencyNewsV3:
+class HighFrequencyNews:
     """
-    This class provides latest and historical news through the HFN V3 API,
+    This class provides latest and historical news through the HFN API,
     with rich filtering by feed, source, language, tags, categories and free text.
 
     * Main use case:
 
-    >>> from btgsolutions_dataservices import HighFrequencyNewsV3
+    >>> from btgsolutions_dataservices import HighFrequencyNews
 
-    >>> hfn = HighFrequencyNewsV3(
+    >>> hfn = HighFrequencyNews(
     >>>     api_key='YOUR_API_KEY',
     >>> )
 

{btgsolutions_dataservices_python_client-3.3.0 → btgsolutions_dataservices_python_client-4.0.0}/btgsolutions_dataservices/websocket/__init__.py

@@ -1,5 +1,4 @@
 from .market_data_websocket_client import MarketDataWebSocketClient
 from .hfn_websocket_client import HFNWebSocketClient
-from .hfn_v3_websocket_client import HFNV3WebSocketClient
 from .market_data_feed import MarketDataFeed
 from .broker_analytics import BrokerAnalyticsWebSocketClient

btgsolutions_dataservices_python_client-3.3.0/btgsolutions_dataservices/websocket/hfn_v3_websocket_client.py → btgsolutions_dataservices_python_client-4.0.0/btgsolutions_dataservices/websocket/hfn_websocket_client.py

@@ -1,5 +1,5 @@
 
-from typing import Optional, Dict, List, Any
+from typing import Optional, Dict, Any
 from ..exceptions import WSTypeError, FeedError
 from ..rest import Authenticator
 from ..config import hfn_v3_socket_url, MAX_WS_RECONNECT_RETRIES
@@ -10,9 +10,9 @@ import ssl
 import threading
 
 
-class HFNV3WebSocketClient:
+class HFNWebSocketClient:
     """
-    This class connects with the BTG Solutions Data Services HFN V3 WebSocket,
+    This class connects with the BTG Solutions Data Services HFN WebSocket,
     providing a bidirectional real-time news stream with rich subscription filters,
     on-demand queries, and reader engagement metrics.
 
@@ -28,9 +28,9 @@ class HFNV3WebSocketClient:
 
     * Main use case:
 
-    >>> from btgsolutions_dataservices import HFNV3WebSocketClient
+    >>> from btgsolutions_dataservices import HFNWebSocketClient
 
-    >>> ws = HFNV3WebSocketClient(
+    >>> ws = HFNWebSocketClient(
     >>>     api_key='YOUR_API_KEY',
     >>> )
     >>> ws.run()
@@ -84,7 +84,7 @@ class HFNV3WebSocketClient:
         reconnect: bool = True,
     ):
         """
-        Initializes a connection to the HFN V3 WebSocket.
+        Initializes a connection to the HFN WebSocket.
 
         Upon successful connection the server sends a ``message`` event containing
         the server-assigned ``clientId``.  Use :meth:`subscribe` afterwards to start

{btgsolutions_dataservices_python_client-3.3.0 → btgsolutions_dataservices_python_client-4.0.0/btgsolutions_dataservices_python_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: btgsolutions_dataservices_python_client
-Version: 3.3.0
+Version: 4.0.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
@@ -383,28 +383,7 @@ bulk_data.get_compressed_data(channel='98', date='2026-01-30', data_type='instru
 
 ```python
 import btgsolutions_dataservices as btg
-ws = btg.HFNWebSocketClient(api_key='YOUR_API_KEY', country='brazil')
-ws.run(on_message=lambda message: print(message))
-
-## The following is optional to keep the program running in a .py file:
-# from time import sleep
-# while True:
-#   sleep(1)
-```
-
-#### High Frequency News
-
-```python
-import btgsolutions_dataservices as btg
-hfn = btg.HighFrequencyNews(api_key='YOUR_API_KEY')
-hfn.latest_news()
-```
-
-#### High Frequency News V3 Stream
-
-```python
-import btgsolutions_dataservices as btg
-ws = btg.HFNV3WebSocketClient(api_key='YOUR_API_KEY')
+ws = btg.HFNWebSocketClient(api_key='YOUR_API_KEY')
 ws.run(on_message=lambda message: print(message))
 
 # Subscribe to live economy news in Portuguese
@@ -420,13 +399,18 @@ ws.available_filters(settings={})
 ws.unsubscribe()
 
 ws.close()
+
+## The following is optional to keep the program running in a .py file:
+# from time import sleep
+# while True:
+#   sleep(1)
 ```
 
-#### High Frequency News V3
+#### High Frequency News
 
 ```python
 import btgsolutions_dataservices as btg
-hfn = btg.HighFrequencyNewsV3(api_key='YOUR_API_KEY')
+hfn = btg.HighFrequencyNews(api_key='YOUR_API_KEY')
 
 # Latest news with filters
 hfn.get_latest_news(feed='economy', text_language='portuguese', limit=10)
@@ -437,7 +421,7 @@ hfn.get_latest_news(tags=['PETR4', 'VALE3'])
 # Historical news for a date range
 hfn.get_historical_news(
     start_date='2026-05-01T00:00:00.000Z',
-    end_date='2026-05-01T23:59:59.999Z',
+    end_date='2026-05-08T23:59:59.999Z',
     feed='economy',
 )
 

{btgsolutions_dataservices_python_client-3.3.0 → btgsolutions_dataservices_python_client-4.0.0}/btgsolutions_dataservices_python_client.egg-info/SOURCES.txt

@@ -22,7 +22,6 @@ btgsolutions_dataservices/rest/bulk_data.py
 btgsolutions_dataservices/rest/company_data.py
 btgsolutions_dataservices/rest/corporate_events.py
 btgsolutions_dataservices/rest/hfn.py
-btgsolutions_dataservices/rest/hfn_v3.py
 btgsolutions_dataservices/rest/historical_candles.py
 btgsolutions_dataservices/rest/historical_candles_crypto.py
 btgsolutions_dataservices/rest/intraday_candles.py
@@ -35,7 +34,6 @@ btgsolutions_dataservices/rest/ticker_last_event.py
 btgsolutions_dataservices/rest/ticker_last_event_polling.py
 btgsolutions_dataservices/websocket/__init__.py
 btgsolutions_dataservices/websocket/broker_analytics.py
-btgsolutions_dataservices/websocket/hfn_v3_websocket_client.py
 btgsolutions_dataservices/websocket/hfn_websocket_client.py
 btgsolutions_dataservices/websocket/market_data_feed.py
 btgsolutions_dataservices/websocket/market_data_websocket_client.py

btgsolutions_dataservices_python_client-3.3.0/btgsolutions_dataservices/rest/hfn.py

@@ -1,323 +0,0 @@
-
-from typing import Optional
-from ..exceptions import BadResponse
-import requests
-from ..config import url_apis
-import json
-import pandas as pd
-from .authenticator import Authenticator
-
-class HighFrequencyNews:
-    """
-    This class provides realtime and historical news of several news .
-
-    * Main use case:
-
-    >>> from btgsolutions_dataservices import HighFrequencyNews
-
-    >>> hfn = HighFrequencyNews(
-    >>>     api_key='YOUR_API_KEY',
-    >>> )
-    >>> latest_news = hfn.latest_news(
-    >>>     n = 15,
-    >>> )
-
-    >>> petro_news = hfn.filter_news(
-    >>>     ticker = 'PETR4',
-    >>> )
-
-    >>> ibov_news = hfn.filter_news(
-    >>>     tag = 'IBOV',
-    >>> )
-
-    >>> news_21_08 = hfn.historical_news(
-    >>>     start_date = '2023-08-21',
-    >>>     end_date = '2023-08-22',
-    >>> )
-
-    >>> available_feeds = hfn.get_available_feeds()
-    >>> available_sources = hfn.get_available_sources()
-    >>> available_tickers = hfn.get_available_tickers()
-    >>> available_tags = hfn.get_available_tags()
-
-    Parameters
-    ----------------
-    api_key: str
-        User identification key.
-        Field is required.
-    """
-    def __init__(
-        self,
-        api_key: Optional[str]
-    ):
-        self.api_key = api_key
-        self.token = Authenticator(self.api_key).token
-        self.headers = {"authorization": f"authorization {self.token}"}
-
-        self.available_countries = ['brazil', 'chile']
-        self.available_feeds = ['raw', 'economy', 'politics', 'crypto', 'cvm', 'ptax']
-
-        self.available_ref_types = ['tickers','tags', 'feeds', 'sources']
-
-        self.min_news = 1
-        self.max_news = 200
-
-    def latest_news(
-        self,
-        feed:str='raw',
-        country:str='brazil',
-        n:int=10,
-        raw_data:bool=False
-    ):     
-        """
-        Latest news by feed.
-
-        Parameters
-        ----------------
-        feed: str
-            News feed.
-            Example: 'raw', 'economy', 'politics', 'crypto', 'cvm'.
-            Default: 'raw'.
-            Field is not required.
-        country: str
-            Country name.
-            Example: 'brazil', 'chile'.
-            Default: 'brazil'.
-            Field is not required.
-        n: int
-            Number of news to be returned.
-            Default: 10.
-            Field is not required.
-        raw_data: bool
-            If True, returns raw data from API, if False, returns a Pandas DataFrame.
-            Default: False.
-            Field is not required.
-        """
-        
-        if country not in self.available_countries:
-            raise Exception(f"Must provide a valid 'country' parameter. Input: '{country}'. Accepted values: {self.available_countries}")
-
-        if feed not in self.available_feeds:
-            raise Exception(f"Must provide a valid 'feed' parameter. Input: '{feed}'. Accepted values: {self.available_feeds}")
-        
-        if not self.min_news < n < self.max_news: 
-            raise Exception(f"Invalid 'n' parameter. Input: '{n}'. 'n' Must be >= {self.min_news} and <= {self.max_news}")
-
-        url = f"{url_apis}/hfn/{country}/latest_news/{feed}?n={n}"
-
-        response = requests.request("GET", url,  headers=self.headers)
-        if response.status_code == 200:
-            response_data = json.loads(response.text)
-            if raw_data:
-                return response_data
-            else: 
-                return pd.DataFrame(response_data)
-        else:
-            response = json.loads(response.text)
-            raise BadResponse(f'Error: {response.get("ApiClientError")}.\n{response.get("SuggestedAction", "")}')
-
-    def filter_news(
-        self,
-        ticker:str=None,
-        tag:str=None,
-        force:bool=True,
-        country:str='brazil',
-        raw_data:bool=False
-    ):
-        """
-        Filter news by ticker or tag. If both ticker and tag are provided, the filter will be by ticker only 
-
-        Parameters
-        ----------------
-        ticker: str
-            Ticker symbol. Will be used to filter news.
-            Example: 'VALE3', 'PETR4'.
-            Field is not required.
-        tag: str
-            Tag name. Will be used to filter news.
-            Example: 'IBOV', 'TESOURO', 'RENDA_FIXA'.
-            Field is not required.
-        force: bool
-            Force to return news even if it does not match the requested parameters.
-            Default: True
-            Example: True, False.
-            Field is required.
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        raw_data: bool
-            If True, returns raw data from API, if False, returns a Pandas DataFrame.
-            Default: False.
-            Field is not required.
-        """
-        if force is True: force_str = 'true'
-        else: force_str = 'false'
-
-        if country not in self.available_countries:
-            raise Exception(f"Must provide a valid 'country' parameter. Input: '{country}'. Accepted values: {self.available_countries}")
-
-        if not isinstance(ticker, str) and not isinstance(tag, str):
-            raise Exception(f"Must provide a ticker or a tag in order to filter news")
-        elif isinstance(ticker, str):
-            url = f"{url_apis}/hfn/{country}/filter_news/tickers/{ticker}?force={force_str}"
-        else:
-            url = f"{url_apis}/hfn/{country}/filter_news/tags/{tag}?force={force_str}"
-
-        response = requests.request("GET", url,  headers=self.headers)
-        if response.status_code == 200:
-            response_data = json.loads(response.text)
-            if raw_data:
-                return response_data
-            else: 
-                return pd.DataFrame(response_data)
-        else:
-            response = json.loads(response.text)
-            raise BadResponse(f'Error: {response.get("ApiClientError")}.\n{response.get("SuggestedAction", "")}')
-
-    def historical_news(
-        self,
-        start_date:str,
-        end_date:str,
-        feed:str='raw',
-        country:str='brazil',
-        raw_data:bool=False
-    ):
-        """
-        Provide a datetime interval and get all the news registered on that interval. The interval between start_date and end_date must be 24 hours maximum.
-
-        Parameters
-        ----------------
-        start_date: str
-            Upper bound for news publishing time. Supported formats: ISO Date (YYYY-MM-DD), Long Date (MMM DD YYYY), Short Date (MM/DD/YYYY).
-            Example: '2023-08-21'.
-            Field is required.
-        end_date: str
-            Lower bound for news publishing time. Supported formats: ISO Date (YYYY-MM-DD), Long Date (MMM DD YYYY), Short Date (MM/DD/YYYY).
-            Example: '2023-08-22'.
-            Field is required.
-        feed: str
-            Feed name.
-            Default: 'raw'
-            Example: 'raw', 'economy', 'politics', 'crypto', 'cvm'.
-            Field is required.
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        raw_data: bool
-            If True, returns raw data from API, if False, returns a Pandas DataFrame.
-            Default: False.
-            Field is not required.
-        """
-        if country not in self.available_countries:
-            raise Exception(f"Must provide a valid 'country' parameter. Input: '{country}'. Accepted values: {self.available_countries}")
-
-        if feed not in self.available_feeds:
-            raise Exception(f"Must provide a valid 'feed' parameter. Input: '{feed}'. Accepted values: {self.available_feeds}")
-        
-        url = f"{url_apis}/hfn/{country}/news_history?start_date={start_date}&end_date={end_date}&feed={feed}"
-
-        response = requests.request("GET", url,  headers=self.headers)
-        if response.status_code == 200:
-            response_data = json.loads(response.text)
-            if raw_data:
-                return response_data
-            else: 
-                return pd.DataFrame(response_data)
-        else:
-            response = json.loads(response.text)
-            raise BadResponse(f'Error: {response.get("ApiClientError")}.\n{response.get("SuggestedAction", "")}')
-
-    def get_available_feeds(self, country:str='brazil'):
-        """
-        This method provides all feeds available for query.   
-
-        Parameters
-        ----------------
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        """
-        return self.__get_available_reference(ref_type='feeds', country=country)
-    
-    def get_available_sources(self, country:str='brazil'):
-        """
-        This method provides all sources available for query.   
-
-        Parameters
-        ----------------
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        """
-        return self.__get_available_reference(ref_type='sources', country=country)
-    
-    def get_available_tickers(self, country:str='brazil'):
-        """
-        This method provides all tickers available for query.   
-
-        Parameters
-        ----------------
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        """
-        return self.__get_available_reference(ref_type='tickers', country=country)
-
-    def get_available_tags(self, country:str='brazil'):
-        """
-        This method provides all tags available for query.   
-
-        Parameters
-        ----------------
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        """
-        return self.__get_available_reference(ref_type='tags', country=country)
-
-    def __get_available_reference(
-        self,
-        ref_type:str,
-        country:str='brazil',
-    ):
-        """
-        Inner function to query reference data by type.   
-
-        Parameters
-        ----------------
-        ref_type: str
-            Reference type.
-            Example: 'brazil', 'chile'.
-            Field is required.
-        country: str
-            Country name.
-            Default: 'brazil'
-            Example: 'brazil', 'chile'.
-            Field is required.
-        """
-        if ref_type not in self.available_ref_types:
-            raise Exception(f"Must provide a valid 'ref_type' parameter. Input: '{ref_type}'. Accepted values: {self.available_ref_types}")
-
-        if country not in self.available_countries:
-            raise Exception(f"Must provide a valid 'country' parameter. Input: '{country}'. Accepted values: {self.available_countries}")
-
-        url = f"{url_apis}/hfn/{country}/available_{ref_type}"
-
-        response = requests.request("GET", url,  headers=self.headers)
-        if response.status_code == 200:
-            return json.loads(response.text)
-        else:
-            response = json.loads(response.text)
-            raise BadResponse(f'Error: {response.get("ApiClientError")}.\n{response.get("SuggestedAction", "")}')

btgsolutions_dataservices_python_client-3.3.0/btgsolutions_dataservices/websocket/hfn_websocket_client.py

@@ -1,191 +0,0 @@
-
-from typing import Optional, List
-from ..exceptions import WSTypeError, DelayedError, FeedError
-from ..rest import Authenticator
-from ..config import hfn_socket_urls, MAX_WS_RECONNECT_RETRIES, VALID_STREAM_TYPES, VALID_COUNTRIES, REALTIME, BR
-from .websocket_default_functions import _on_open, _on_message, _on_error, _on_close
-import websocket 
-import json
-import ssl
-import threading
-
-class HFNWebSocketClient:
-    """
-    This class connects with BTG Solutions Data Services HFN WebSocket, receiving high frequency news in realtime or delayed feeds.
-
-    * Main use case:
-
-    >>> from btgsolutions_dataservices import HFNWebSocketClient
-    >>> ws = HFNWebSocketClient(
-    >>>     api_key='YOUR_API_KEY',
-    >>>     stream_type='realtime',
-    >>>     country='brazil',
-    >>>     ssl=True
-    >>> )
-    >>> ws.run()
-    >>> ws.get_latest_news()
-    >>> ws.close()
-
-    Parameters
-    ----------------
-    api_key: str
-        User identification key.
-        Field is required.
-
-    stream_type: str
-        Websocket connection feed.
-        Options: 'realtime', 'delayed'.
-        Field is not required. Default: 'realtime'.
-
-    country: str
-        Country name.
-        Options: 'brazil' or 'chile'.
-        Field is not required. Default: 'brazil'.
-
-    ssl: bool
-        Enable or disable ssl configuration.
-        Field is not required. Default: True (enable).
-    """
-    def __init__(
-        self,
-        api_key:str,
-        stream_type:Optional[str] = REALTIME,
-        country:Optional[str] = BR,
-        ssl:Optional[bool] = True,
-        **kwargs,
-    ):
-        self.api_key = api_key
-        self.ssl = ssl
-
-        self.__authenticator = Authenticator(self.api_key)
-        self.__nro_reconnect_retries = 0
-
-        if stream_type not in VALID_STREAM_TYPES:
-            raise FeedError(f"Must provide a valid 'stream_type' parameter. Valid options are: {VALID_STREAM_TYPES}")
-        if country not in VALID_COUNTRIES:
-            raise FeedError(f"Must provide a valid 'country' parameter. Valid options are: {VALID_COUNTRIES}")
-
-        try:
-            self.url = hfn_socket_urls[country][stream_type]
-        except:
-            raise WSTypeError(f"There is no WebSocket type for your specifications (stream_type:{stream_type}, country:{country})\nPlease check your request parameters and try again")
-            
-        self.websocket_cfg = kwargs
-    
-    def run(
-        self,
-        on_open = None,
-        on_message = None,
-        on_error = None,
-        on_close = None,
-        reconnect=True
-    ):
-        """
-        Initializes a connection to websocket and starts to receive high frequency news.
-
-        Parameters
-        ----------
-        on_open: function
-            - Called at opening connection to websocket.
-            - Field is not required. 
-            - Default: prints that the connection was opened in case of success.
-        
-        on_message: function
-            - Called every time it receives a message.
-            - Arguments:
-                1. Data received from the server.
-            - Field is not required. 
-            - Default: prints the data.
-
-        on_error: function
-            - Called when a error occurs.
-            - Arguments: 
-                1. Exception object.
-            - Field is not required. 
-            - Default: prints the error.
-
-        on_close: function
-            - Called when connection is closed.
-            - Arguments: 
-                1. close_status_code.
-                2. close_msg.
-            - Field is not required. 
-            - Default: prints a message that the connection was closed.
-        reconnect: bool
-            Try reconnect if connection is closed.
-            Field is not required.
-            Default: True.
-        """
-        if on_open is None:
-            on_open = _on_open
-        if on_message is None:
-            on_message = _on_message
-        if on_error is None:
-            on_error = _on_error
-        if on_close is None:
-            on_close = _on_close
-
-        def intermediary_on_open(ws):
-            on_open()
-            self.__nro_reconnect_retries = 0
-
-        def intermediary_on_message(ws, data):
-            on_message(data)
-
-        def intermediary_on_error(ws, error):
-            on_error(error)
-
-        def intermediary_on_close(ws, close_status_code, close_msg):
-            on_close(close_status_code, close_msg)
-            
-            if reconnect:
-                if self.__nro_reconnect_retries == MAX_WS_RECONNECT_RETRIES:
-                    print(f"### Fail retriyng reconnect")
-                    return
-                self.__nro_reconnect_retries +=1
-                print(f"### Reconnecting.... Attempts: {self.__nro_reconnect_retries}/{MAX_WS_RECONNECT_RETRIES}")
-                self.run(on_open, on_message, on_error, on_close, reconnect)
-
-        self.ws = websocket.WebSocketApp(
-            url=self.url,
-            on_open=intermediary_on_open,
-            on_message=intermediary_on_message,
-            on_error=intermediary_on_error,
-            on_close=intermediary_on_close,
-            header={
-                "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.54 Safari/537.36",
-                "Sec-WebSocket-Protocol": self.__authenticator.token,
-            }
-        )
-
-        ssl_conf = {} if self.ssl else {"sslopt": {"cert_reqs": ssl.CERT_NONE}}
-        wst = threading.Thread(target=self.ws.run_forever, kwargs=ssl_conf)
-        wst.daemon = True
-        wst.start()
-
-        while True:
-            if self.ws.sock is not None and self.ws.sock.connected:
-                break
-            pass
-
-    def __send(self, data):
-        """
-        Class method to be used internally. Sends data to websocket.
-        """
-        if not isinstance(data, str):
-            data = json.dumps(data)   
-        print(f'Sending data: {data}')
-        return self.ws.send(data)
-    
-    def close(self):
-        """
-        Closes connection with websocket.
-        """
-        self.ws.close()
-        
-    def get_latest_news(self):
-        """
-        Get the latest news from our High Frequency News service.
-
-        """
-        self.__send({'action':'latest_news'})