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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: btgsolutions_dataservices_python_client
-Version: 3.2.11
+Version: 3.3.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
@@ -280,6 +280,14 @@ hist_candles = btg.HistoricalCandles(api_key='YOUR_API_KEY')
 hist_candles.get_intraday_history_candles(ticker='PETR4',  market_type='stocks', corporate_events_adj=True, date='2023-10-06', candle='1m', rmv_after_market=True, timezone='UTC', raw_data=False, round=True)
 ```
 
+##### Interday Batch
+
+```python
+import btgsolutions_dataservices as btg
+hist_candles = btg.HistoricalCandles(api_key='YOUR_API_KEY')
+hist_candles.get_interday_history_candles_batch(market_type='stocks', tickers=['PETR4', 'VALE3'], start_date='2023-10-01', end_date='2023-10-13', corporate_events_adj=True, rmv_after_market=True, timezone='UTC', raw_data=False, round=True)
+```
+
 ##### Available Tickers
 
 ```python
@@ -392,6 +400,51 @@ 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.run(on_message=lambda message: print(message))
+
+# Subscribe to live economy news in Portuguese
+ws.subscribe(settings={'feed': 'economy', 'text_language': 'portuguese'})
+
+# Request latest news on demand (without subscribing to the live stream)
+ws.latest_news(settings={'feed': 'crypto', 'limit': '10'})
+
+# Get available filter values
+ws.available_filters(settings={})
+
+# Stop receiving broadcasts (keeps connection open)
+ws.unsubscribe()
+
+ws.close()
+```
+
+#### High Frequency News V3
+
+```python
+import btgsolutions_dataservices as btg
+hfn = btg.HighFrequencyNewsV3(api_key='YOUR_API_KEY')
+
+# Latest news with filters
+hfn.get_latest_news(feed='economy', text_language='portuguese', limit=10)
+
+# Latest news by ticker tags
+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',
+    feed='economy',
+)
+
+# Available filter values
+hfn.get_available_filters()
+```
+
 #### OPA
 
 ```python
@@ -484,6 +537,98 @@ company_data = btg.CompanyData(api_key='YOUR_API_KEY')
 company_data.all_financial_tables(ticker='PETR4')
 ```
 
+#### Alternative Data - Metadata
+
+```python
+import btgsolutions_dataservices as btg
+meta = btg.AlternativeDataMetadata(api_key='YOUR_API_KEY')
+meta.get_company_directory(query='PETROBRAS', jurisdiction='BR')
+meta.get_company_sector(identifier='PETR4')
+meta.get_taxonomy(system='b3')
+meta.get_cnae(code='6422100')
+meta.get_sector_companies(sector='Petróleo, Gás e Biocombustíveis')
+meta.get_sectors_summary()
+meta.get_financial_statement_types()
+meta.get_datasets()
+meta.get_available_assets(dataset='maximum_theoretical_margin', prefix='PETR')
+meta.get_available_indicators()
+```
+
+#### Alternative Data - Companies
+
+```python
+import btgsolutions_dataservices as btg
+companies = btg.AlternativeDataCompanies(api_key='YOUR_API_KEY')
+companies.get_board(company_id='VALE3', body='board')
+companies.get_governance_summary(company_id='ITUB4')
+companies.get_governance_history(company_id='PETR4', start_date='2023-01-01', end_date='2024-12-31')
+companies.get_governance_documents(company_id='PETR4', start_date='2024-01-01', end_date='2024-12-31')
+companies.get_governance_compensation(company_id='VALE3', fiscal_year='2024')
+companies.get_governance_related_party(company_id='ITUB4')
+companies.get_governance_beneficial_ownership(company_id='VALE3')
+companies.get_corporate_registry(company_id='PETR4', direction='partners')
+companies.get_corporate_registry(company_id='PETR4', direction='investees')
+companies.get_insider_trades(company_id='AAPL', start_date='2024-01-01', end_date='2024-12-31')
+companies.get_board_changes(company_id='VALE3', event='appointed')
+companies.get_financial_statements(company_id='PETR4', statement='income_statement', quarter='Q42024')
+companies.get_financial_notes(company_id='VALE3', quarter='Q42024')
+companies.get_disclosures(company_id='PETR4', document_type='repurchase')
+companies.get_disclosures(company_id='PETR4', document_type='insider')
+```
+
+#### Alternative Data - People
+
+```python
+import btgsolutions_dataservices as btg
+people = btg.AlternativeDataPeople(api_key='YOUR_API_KEY')
+people.get_appointments(person_id='slug:Jean Paul Lemann', active_only=True)
+people.get_appointments(person_id='slug:Jean Paul Lemann', group_by='company')
+```
+
+#### Alternative Data - Funds
+
+```python
+import btgsolutions_dataservices as btg
+funds = btg.AlternativeDataFunds(api_key='YOUR_API_KEY')
+funds.get_holdings(fund_id='73.232.530/0001-46', reference_date='2024-12-31')
+funds.get_exposures(fund_id='73.232.530/0001-46', exposure_type='asset_class')
+funds.get_history(fund_id='73.232.530/0001-46', start_date='2024-01-01', end_date='2024-12-31')
+funds.get_lookthrough(fund_id='73.232.530/0001-46')
+funds.get_manager_aggregate_holdings(manager_id='ITAÚ ASSET MANAGEMENT')
+```
+
+#### Alternative Data - Ownership
+
+```python
+import btgsolutions_dataservices as btg
+ownership = btg.AlternativeDataOwnership(api_key='YOUR_API_KEY')
+ownership.get_top_shareholders(company_id='VALE3', limit=10)
+ownership.get_ownership_current(company_id='ITUB4')
+ownership.get_ownership_history(company_id='PETR4', start_date='2023-01-01', end_date='2024-12-31')
+ownership.get_ownership_change_events(company_id='VALE3', start_date='2024-01-01', end_date='2024-12-31')
+ownership.get_ownership_official_notices(company_id='PETR4')
+ownership.get_ownership_control_group(company_id='VALE3')
+ownership.get_ownership_free_float(company_id='PETR4')
+ownership.get_shareholder_holdings(shareholder_id='00.000.000/0001-91')
+ownership.get_institutional_holders(identifier='VALE3')
+ownership.get_fund_holders(identifier='PETR4', identifier_type='b3_ticker')
+```
+
+#### Alternative Data - Macro & Markets
+
+```python
+import btgsolutions_dataservices as btg
+macro = btg.AlternativeDataMacroMarkets(api_key='YOUR_API_KEY')
+macro.get_macro_indicators(indicator='selic')
+macro.get_macro_indicators(indicator='ipca_contributions', start_date='2024-01', end_date='2024-12')
+macro.get_macro_indicators(indicator='gdp', type='yoy')
+macro.get_macro_indicators(indicator='comexstat', year='2024', state='SP')
+macro.get_macro_indicators(indicator='rreo', year='2024', period='6')
+macro.get_maximum_theoretical_margin(asset='PETR4', report_date='2024-12-31')
+macro.get_dpmfi(start_date='2024-01', end_date='2024-12', status='dados_oficiais')
+macro.get_dpmfi_composition(bond_type='IPCA')
+```
+
 ### Reference Data
 
 #### Corporate Events
@@ -510,23 +655,33 @@ import btgsolutions_dataservices as btg
 book_scope = btg.BookScope(api_key='YOUR_API_KEY')
 
 result = book_scope.get(
-    symbol='PETR4',
-    market_type='Equities',
-    start_time='2026-05-22T15:50:00Z',
-    end_time='2026-05-22T16:00:00Z',
+    symbol='DOLM26',
+    market_type='derivatives',
+    start_time='2026-05-28T14:12:00Z',
+    end_time='2026-05-28T14:15:00Z',
     select=['trades', 'book_snapshot', 'book_incremental'],  # choose one, two, or all three
 )
 
 single_file_result = book_scope.get(
-    symbol='PETR4',
-    market_type='Equities',
-    start_time='2026-05-22T15:50:00Z',
-    end_time='2026-05-22T16:00:00Z',
+    symbol='DOLM26',
+    market_type='derivatives',
+    start_time='2026-05-28T14:12:00Z',
+    end_time='2026-05-28T14:15:00Z',
     select=['trades', 'book_snapshot', 'book_incremental'],
     aggregate_info=True,
 )
 ```
 
+#### Broker Analytics
+
+```python
+import btgsolutions_dataservices as btg
+broker_analytics = btg.BrokerAnalytics(api_key='YOUR_API_KEY', market_type='stocks')
+summary = broker_analytics.get_summary(brokers=['85', '3'], tickers=['PETR4', 'ABCB4'])
+top_brokers = broker_analytics.get_top_brokers(n=10)
+top_tickers = broker_analytics.get_top_tickers(n=10, brokers=['85', '3'])
+```
+
 #### Ticker Reference Data
 
 ```python

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

@@ -257,6 +257,14 @@ hist_candles = btg.HistoricalCandles(api_key='YOUR_API_KEY')
 hist_candles.get_intraday_history_candles(ticker='PETR4',  market_type='stocks', corporate_events_adj=True, date='2023-10-06', candle='1m', rmv_after_market=True, timezone='UTC', raw_data=False, round=True)
 ```
 
+##### Interday Batch
+
+```python
+import btgsolutions_dataservices as btg
+hist_candles = btg.HistoricalCandles(api_key='YOUR_API_KEY')
+hist_candles.get_interday_history_candles_batch(market_type='stocks', tickers=['PETR4', 'VALE3'], start_date='2023-10-01', end_date='2023-10-13', corporate_events_adj=True, rmv_after_market=True, timezone='UTC', raw_data=False, round=True)
+```
+
 ##### Available Tickers
 
 ```python
@@ -369,6 +377,51 @@ 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.run(on_message=lambda message: print(message))
+
+# Subscribe to live economy news in Portuguese
+ws.subscribe(settings={'feed': 'economy', 'text_language': 'portuguese'})
+
+# Request latest news on demand (without subscribing to the live stream)
+ws.latest_news(settings={'feed': 'crypto', 'limit': '10'})
+
+# Get available filter values
+ws.available_filters(settings={})
+
+# Stop receiving broadcasts (keeps connection open)
+ws.unsubscribe()
+
+ws.close()
+```
+
+#### High Frequency News V3
+
+```python
+import btgsolutions_dataservices as btg
+hfn = btg.HighFrequencyNewsV3(api_key='YOUR_API_KEY')
+
+# Latest news with filters
+hfn.get_latest_news(feed='economy', text_language='portuguese', limit=10)
+
+# Latest news by ticker tags
+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',
+    feed='economy',
+)
+
+# Available filter values
+hfn.get_available_filters()
+```
+
 #### OPA
 
 ```python
@@ -461,6 +514,98 @@ company_data = btg.CompanyData(api_key='YOUR_API_KEY')
 company_data.all_financial_tables(ticker='PETR4')
 ```
 
+#### Alternative Data - Metadata
+
+```python
+import btgsolutions_dataservices as btg
+meta = btg.AlternativeDataMetadata(api_key='YOUR_API_KEY')
+meta.get_company_directory(query='PETROBRAS', jurisdiction='BR')
+meta.get_company_sector(identifier='PETR4')
+meta.get_taxonomy(system='b3')
+meta.get_cnae(code='6422100')
+meta.get_sector_companies(sector='Petróleo, Gás e Biocombustíveis')
+meta.get_sectors_summary()
+meta.get_financial_statement_types()
+meta.get_datasets()
+meta.get_available_assets(dataset='maximum_theoretical_margin', prefix='PETR')
+meta.get_available_indicators()
+```
+
+#### Alternative Data - Companies
+
+```python
+import btgsolutions_dataservices as btg
+companies = btg.AlternativeDataCompanies(api_key='YOUR_API_KEY')
+companies.get_board(company_id='VALE3', body='board')
+companies.get_governance_summary(company_id='ITUB4')
+companies.get_governance_history(company_id='PETR4', start_date='2023-01-01', end_date='2024-12-31')
+companies.get_governance_documents(company_id='PETR4', start_date='2024-01-01', end_date='2024-12-31')
+companies.get_governance_compensation(company_id='VALE3', fiscal_year='2024')
+companies.get_governance_related_party(company_id='ITUB4')
+companies.get_governance_beneficial_ownership(company_id='VALE3')
+companies.get_corporate_registry(company_id='PETR4', direction='partners')
+companies.get_corporate_registry(company_id='PETR4', direction='investees')
+companies.get_insider_trades(company_id='AAPL', start_date='2024-01-01', end_date='2024-12-31')
+companies.get_board_changes(company_id='VALE3', event='appointed')
+companies.get_financial_statements(company_id='PETR4', statement='income_statement', quarter='Q42024')
+companies.get_financial_notes(company_id='VALE3', quarter='Q42024')
+companies.get_disclosures(company_id='PETR4', document_type='repurchase')
+companies.get_disclosures(company_id='PETR4', document_type='insider')
+```
+
+#### Alternative Data - People
+
+```python
+import btgsolutions_dataservices as btg
+people = btg.AlternativeDataPeople(api_key='YOUR_API_KEY')
+people.get_appointments(person_id='slug:Jean Paul Lemann', active_only=True)
+people.get_appointments(person_id='slug:Jean Paul Lemann', group_by='company')
+```
+
+#### Alternative Data - Funds
+
+```python
+import btgsolutions_dataservices as btg
+funds = btg.AlternativeDataFunds(api_key='YOUR_API_KEY')
+funds.get_holdings(fund_id='73.232.530/0001-46', reference_date='2024-12-31')
+funds.get_exposures(fund_id='73.232.530/0001-46', exposure_type='asset_class')
+funds.get_history(fund_id='73.232.530/0001-46', start_date='2024-01-01', end_date='2024-12-31')
+funds.get_lookthrough(fund_id='73.232.530/0001-46')
+funds.get_manager_aggregate_holdings(manager_id='ITAÚ ASSET MANAGEMENT')
+```
+
+#### Alternative Data - Ownership
+
+```python
+import btgsolutions_dataservices as btg
+ownership = btg.AlternativeDataOwnership(api_key='YOUR_API_KEY')
+ownership.get_top_shareholders(company_id='VALE3', limit=10)
+ownership.get_ownership_current(company_id='ITUB4')
+ownership.get_ownership_history(company_id='PETR4', start_date='2023-01-01', end_date='2024-12-31')
+ownership.get_ownership_change_events(company_id='VALE3', start_date='2024-01-01', end_date='2024-12-31')
+ownership.get_ownership_official_notices(company_id='PETR4')
+ownership.get_ownership_control_group(company_id='VALE3')
+ownership.get_ownership_free_float(company_id='PETR4')
+ownership.get_shareholder_holdings(shareholder_id='00.000.000/0001-91')
+ownership.get_institutional_holders(identifier='VALE3')
+ownership.get_fund_holders(identifier='PETR4', identifier_type='b3_ticker')
+```
+
+#### Alternative Data - Macro & Markets
+
+```python
+import btgsolutions_dataservices as btg
+macro = btg.AlternativeDataMacroMarkets(api_key='YOUR_API_KEY')
+macro.get_macro_indicators(indicator='selic')
+macro.get_macro_indicators(indicator='ipca_contributions', start_date='2024-01', end_date='2024-12')
+macro.get_macro_indicators(indicator='gdp', type='yoy')
+macro.get_macro_indicators(indicator='comexstat', year='2024', state='SP')
+macro.get_macro_indicators(indicator='rreo', year='2024', period='6')
+macro.get_maximum_theoretical_margin(asset='PETR4', report_date='2024-12-31')
+macro.get_dpmfi(start_date='2024-01', end_date='2024-12', status='dados_oficiais')
+macro.get_dpmfi_composition(bond_type='IPCA')
+```
+
 ### Reference Data
 
 #### Corporate Events
@@ -487,23 +632,33 @@ import btgsolutions_dataservices as btg
 book_scope = btg.BookScope(api_key='YOUR_API_KEY')
 
 result = book_scope.get(
-    symbol='PETR4',
-    market_type='Equities',
-    start_time='2026-05-22T15:50:00Z',
-    end_time='2026-05-22T16:00:00Z',
+    symbol='DOLM26',
+    market_type='derivatives',
+    start_time='2026-05-28T14:12:00Z',
+    end_time='2026-05-28T14:15:00Z',
     select=['trades', 'book_snapshot', 'book_incremental'],  # choose one, two, or all three
 )
 
 single_file_result = book_scope.get(
-    symbol='PETR4',
-    market_type='Equities',
-    start_time='2026-05-22T15:50:00Z',
-    end_time='2026-05-22T16:00:00Z',
+    symbol='DOLM26',
+    market_type='derivatives',
+    start_time='2026-05-28T14:12:00Z',
+    end_time='2026-05-28T14:15:00Z',
     select=['trades', 'book_snapshot', 'book_incremental'],
     aggregate_info=True,
 )
 ```
 
+#### Broker Analytics
+
+```python
+import btgsolutions_dataservices as btg
+broker_analytics = btg.BrokerAnalytics(api_key='YOUR_API_KEY', market_type='stocks')
+summary = broker_analytics.get_summary(brokers=['85', '3'], tickers=['PETR4', 'ABCB4'])
+top_brokers = broker_analytics.get_top_brokers(n=10)
+top_tickers = broker_analytics.get_top_tickers(n=10, brokers=['85', '3'])
+```
+
 #### Ticker Reference Data
 
 ```python

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

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

{btgsolutions_dataservices_python_client-3.2.11 → btgsolutions_dataservices_python_client-3.3.0}/btgsolutions_dataservices/config.py

@@ -137,6 +137,8 @@ hfn_socket_urls = {
     },
 }
 
+hfn_v3_socket_url = f'{url_ws}v3/hfn'
+
 broker_analytics_socket_urls = {
     BR: {
         REALTIME: f'{base_url_ws}{ws_br_b3_base_path}broker-analytics',

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

@@ -4,6 +4,7 @@ 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
@@ -15,3 +16,10 @@ from .stock_loan import StockLoan
 from .ticker_last_event_polling import TickerLastEventPolling
 from .broker_reference import BrokerReference
 from .book_scope import BookScope
+from .broker_analytics import BrokerAnalytics
+from .alternative_data_metadata import AlternativeDataMetadata
+from .alternative_data_companies import AlternativeDataCompanies
+from .alternative_data_people import AlternativeDataPeople
+from .alternative_data_funds import AlternativeDataFunds
+from .alternative_data_ownership import AlternativeDataOwnership
+from .alternative_data_macro_markets import AlternativeDataMacroMarkets