btgsolutions-dataservices-python-client 4.5.0__tar.gz → 4.5.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. {btgsolutions_dataservices_python_client-4.5.0/btgsolutions_dataservices_python_client.egg-info → btgsolutions_dataservices_python_client-4.5.1}/PKG-INFO +14 -1
  2. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/README.md +19 -6
  3. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/__init__.py +1 -1
  4. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_catalog.py +38 -18
  5. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_companies.py +17 -7
  6. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_ownership.py +15 -7
  7. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1/btgsolutions_dataservices_python_client.egg-info}/PKG-INFO +14 -1
  8. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/LICENSE +0 -0
  9. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/MANIFEST.in +0 -0
  10. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/config.py +0 -0
  11. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/exceptions.py +0 -0
  12. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/__init__.py +0 -0
  13. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_funds.py +0 -0
  14. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_macro_markets.py +0 -0
  15. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_metadata.py +0 -0
  16. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/alternative_data_people.py +0 -0
  17. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/authenticator.py +0 -0
  18. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/book_scope.py +0 -0
  19. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/broker_analytics.py +0 -0
  20. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/broker_reference.py +0 -0
  21. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/bulk_data.py +0 -0
  22. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/company_data.py +0 -0
  23. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/corporate_events.py +0 -0
  24. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/dataservices_catalog.py +0 -0
  25. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/hfn.py +0 -0
  26. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/historical_candles.py +0 -0
  27. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/historical_candles_crypto.py +0 -0
  28. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/intraday_candles.py +0 -0
  29. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/intraday_tick_data.py +0 -0
  30. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/public_sources.py +0 -0
  31. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/quotes.py +0 -0
  32. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/reference_data.py +0 -0
  33. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/stock_loan.py +0 -0
  34. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/ticker_last_event.py +0 -0
  35. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/rest/ticker_last_event_polling.py +0 -0
  36. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/websocket/__init__.py +0 -0
  37. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/websocket/broker_analytics.py +0 -0
  38. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/websocket/hfn_websocket_client.py +0 -0
  39. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/websocket/market_data_feed.py +0 -0
  40. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/websocket/market_data_websocket_client.py +0 -0
  41. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices/websocket/websocket_default_functions.py +0 -0
  42. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices_python_client.egg-info/SOURCES.txt +0 -0
  43. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices_python_client.egg-info/dependency_links.txt +0 -0
  44. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices_python_client.egg-info/requires.txt +0 -0
  45. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/btgsolutions_dataservices_python_client.egg-info/top_level.txt +0 -0
  46. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/pyproject.toml +0 -0
  47. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/requirements.txt +0 -0
  48. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/setup.cfg +0 -0
  49. {btgsolutions_dataservices_python_client-4.5.0 → btgsolutions_dataservices_python_client-4.5.1}/setup.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: btgsolutions_dataservices_python_client
3
- Version: 4.5.0
3
+ Version: 4.5.1
4
4
  Summary: Python package containing several classes and data for extracting and manipulating market and trading data.
5
5
  Home-page: https://github.com/BTG-Pactual-Solutions/btgsolutions-dataservices-python-client
6
6
  Author: BTG Solutions Data Services powered by BTG Pactual Solutions
@@ -620,6 +620,12 @@ companies.get_disclosures(company_id='PETR4', document_type='repurchase')
620
620
  companies.get_disclosures(company_id='PETR4', document_type='insider')
621
621
  ```
622
622
 
623
+ For Brazilian governance endpoints, current board and summary responses prefer
624
+ the latest raw FRE filing when available. Returned governance summaries can
625
+ include `latest_reference_date`, `latest_version`, `latest_document_id` and
626
+ `structure_source`; alternate B3 tickers/units such as `BPAC11` can resolve to
627
+ the underlying listed company when covered by the source metadata.
628
+
623
629
  #### Alternative Data - People
624
630
 
625
631
  ```python
@@ -661,6 +667,13 @@ ownership.get_institutional_holders(identifier='VALE3')
661
667
  ownership.get_fund_holders(identifier='PETR4', identifier_type='b3_ticker')
662
668
  ```
663
669
 
670
+ For Brazilian ownership/free-float endpoints, current control and free-float
671
+ responses use the latest FRE source document/version for the selected reference
672
+ date when available. Repeated older source documents are deduplicated where
673
+ possible, while distinct rows for the same holder across classes, roles or
674
+ ownership categories are preserved. Zero free-float or independence percentages
675
+ can be valid source values, not missing data.
676
+
664
677
  #### Alternative Data - Macro & Markets
665
678
 
666
679
  ```python
@@ -593,9 +593,15 @@ companies.get_board_changes(company_id='VALE3', event='elected')
593
593
  companies.get_assemblies(company_id='PINE4')
594
594
  companies.get_financial_statements(company_id='PETR4', statement='income_statement', quarter='4T24')
595
595
  companies.get_financial_notes(company_id='VALE3', quarter='4T24')
596
- companies.get_disclosures(company_id='PETR4', document_type='repurchase')
597
- companies.get_disclosures(company_id='PETR4', document_type='insider')
598
- ```
596
+ companies.get_disclosures(company_id='PETR4', document_type='repurchase')
597
+ companies.get_disclosures(company_id='PETR4', document_type='insider')
598
+ ```
599
+
600
+ For Brazilian governance endpoints, current board and summary responses prefer
601
+ the latest raw FRE filing when available. Returned governance summaries can
602
+ include `latest_reference_date`, `latest_version`, `latest_document_id` and
603
+ `structure_source`; alternate B3 tickers/units such as `BPAC11` can resolve to
604
+ the underlying listed company when covered by the source metadata.
599
605
 
600
606
  #### Alternative Data - People
601
607
 
@@ -634,9 +640,16 @@ ownership.get_notice_summary(url='https://www.rad.cvm.gov.br/ENETWEB/frmGerencia
634
640
  ownership.get_ownership_control_group(company_id='VALE3')
635
641
  ownership.get_ownership_free_float(company_id='PETR4')
636
642
  ownership.get_shareholder_holdings(shareholder_id='00.000.000/0001-91')
637
- ownership.get_institutional_holders(identifier='VALE3')
638
- ownership.get_fund_holders(identifier='PETR4', identifier_type='b3_ticker')
639
- ```
643
+ ownership.get_institutional_holders(identifier='VALE3')
644
+ ownership.get_fund_holders(identifier='PETR4', identifier_type='b3_ticker')
645
+ ```
646
+
647
+ For Brazilian ownership/free-float endpoints, current control and free-float
648
+ responses use the latest FRE source document/version for the selected reference
649
+ date when available. Repeated older source documents are deduplicated where
650
+ possible, while distinct rows for the same holder across classes, roles or
651
+ ownership categories are preserved. Zero free-float or independence percentages
652
+ can be valid source values, not missing data.
640
653
 
641
654
  #### Alternative Data - Macro & Markets
642
655
 
@@ -1,4 +1,4 @@
1
- __version__ = "4.5.0"
1
+ __version__ = "4.5.1"
2
2
 
3
3
  from .websocket import *
4
4
  from .rest import *
@@ -53,12 +53,16 @@ PUBLIC_SOURCES_DATA_GAPS: dict[str, str] = {
53
53
  "can change matches."
54
54
  ),
55
55
  "get_company_board": (
56
- "For Brazilian companies, body='board' can include Conselho Fiscal rows "
56
+ "For Brazilian companies, current board/executive composition prefers "
57
+ "the latest raw FRE rows over older materialized snapshots and orders "
58
+ "FRE versions numerically. body='board' can include Conselho Fiscal rows "
57
59
  "alongside Conselho de Administracao rows depending on the filing. For "
58
60
  "a board-of-directors answer, filter returned rows by governance_body "
59
- "or role to keep Conselho de Administracao only. Committee responses "
60
- "can include broad aggregates such as Outros Comites; do not infer "
61
- "granular committee names unless they are present in returned fields."
61
+ "or role to keep Conselho de Administracao only. body='executive' "
62
+ "deduplicates mixed board/executive rows by person where possible. "
63
+ "Committee responses can include broad aggregates such as Outros "
64
+ "Comites; do not infer granular committee names unless they are present "
65
+ "in returned fields."
62
66
  ),
63
67
  "get_board_changes": (
64
68
  "Brazilian board-change rows can be materialized from FRE snapshot "
@@ -108,10 +112,11 @@ PUBLIC_SOURCES_DATA_GAPS: dict[str, str] = {
108
112
  "get_ownership_free_float and get_ownership_official_notices when this "
109
113
  "endpoint returns no rows. "
110
114
  "This endpoint does not synthesize top holders from current ownership "
111
- "or free-float tables. Some responses can include multiple rows for "
112
- "the same holder across share classes, ownership categories, filings "
113
- "or source protocols; inspect category, class, protocol/source and "
114
- "reference date before aggregating percentages."
115
+ "or free-float tables. The API deduplicates repeated rows from older "
116
+ "FRE source documents for the same reference date where possible, while "
117
+ "preserving distinct rows for the same holder across share classes, "
118
+ "ownership categories or roles; inspect category, class, protocol/source "
119
+ "and reference date before aggregating percentages."
115
120
  ),
116
121
  "ownership_reporting_dates": (
117
122
  "Brazilian ownership and free-float reference_date fields often come "
@@ -119,7 +124,9 @@ PUBLIC_SOURCES_DATA_GAPS: dict[str, str] = {
119
124
  "structures. They are reporting/reference dates, not necessarily the "
120
125
  "calendar date when the data was loaded or a strict as-of timestamp; a "
121
126
  "reference_date can be after the current calendar date when it denotes "
122
- "a filing year/base period."
127
+ "a filing year/base period. For FRE tables with multiple filed versions "
128
+ "on the same reference date, current control/free-float/governance "
129
+ "responses prefer the latest source document or numeric version."
123
130
  ),
124
131
  "get_ownership_history": (
125
132
  "Ownership history uses the same normalized ownership_snapshot layer as "
@@ -632,9 +639,10 @@ PUBLIC_SOURCES_ENDPOINTS: dict[str, dict[str, Any]] = {
632
639
  "description": (
633
640
  "Get members of a company's governance body. body can be board, "
634
641
  "executive or committee; committee filters a specific committee when "
635
- "body='committee'. For Brazilian filings, body='board' can include "
636
- "Conselho Fiscal rows; filter governance_body/role for Conselho de "
637
- "Administracao when answering board-of-directors questions."
642
+ "body='committee'. For Brazilian filings, latest raw FRE rows are "
643
+ "preferred when present; body='board' can include Conselho Fiscal "
644
+ "rows; filter governance_body/role for Conselho de Administracao "
645
+ "when answering board-of-directors questions."
638
646
  ),
639
647
  "parameters": {
640
648
  "company_id": PUBLIC_SOURCES_CONVENTIONS["company_id"],
@@ -655,8 +663,11 @@ PUBLIC_SOURCES_ENDPOINTS: dict[str, dict[str, Any]] = {
655
663
  "client": "AlternativeDataCompanies",
656
664
  "description": (
657
665
  "Get a compact latest governance snapshot for a company as a "
658
- "composite object. It can include board size, committees, CEO and "
659
- "free-float-related fields when available."
666
+ "composite object. For Brazilian companies, current counts are "
667
+ "derived from the latest raw FRE filing when available and can "
668
+ "include latest_reference_date, latest_version, latest_document_id, "
669
+ "structure_source, board size, independent members, fiscal council "
670
+ "size, executives, committees and CEO."
660
671
  ),
661
672
  "parameters": {"company_id": PUBLIC_SOURCES_CONVENTIONS["company_id"]},
662
673
  "relationships": ["company_resolution", "company_trading_bridge"],
@@ -1170,7 +1181,9 @@ PUBLIC_SOURCES_ENDPOINTS: dict[str, dict[str, Any]] = {
1170
1181
  "description": (
1171
1182
  "Get top shareholders for a company from the normalized "
1172
1183
  "ownership_snapshot layer when shareholder-level snapshots are "
1173
- "available. Brazilian CVM/FRE rows are periodic filing snapshots."
1184
+ "available. Brazilian CVM/FRE rows are periodic filing snapshots; "
1185
+ "older repeated FRE source documents for the same reference date "
1186
+ "are deduplicated where possible."
1174
1187
  ),
1175
1188
  "parameters": {
1176
1189
  "company_id": PUBLIC_SOURCES_CONVENTIONS["company_id"],
@@ -1198,7 +1211,9 @@ PUBLIC_SOURCES_ENDPOINTS: dict[str, dict[str, Any]] = {
1198
1211
  "client": "AlternativeDataOwnership",
1199
1212
  "description": (
1200
1213
  "Get current ownership structure of a listed company as a composite "
1201
- "object. Use this for latest control, free-float and ownership summary context."
1214
+ "object. Use this for latest control, free-float and ownership summary "
1215
+ "context. For Brazilian FRE data, current control/free-float blocks "
1216
+ "prefer the latest source document for the selected reference date."
1202
1217
  ),
1203
1218
  "parameters": {"company_id": PUBLIC_SOURCES_CONVENTIONS["company_id"]},
1204
1219
  "relationships": [
@@ -1335,7 +1350,10 @@ PUBLIC_SOURCES_ENDPOINTS: dict[str, dict[str, Any]] = {
1335
1350
  "description": (
1336
1351
  "Get controlling shareholders, shareholder agreements and control "
1337
1352
  "evidence for a company as a composite object. Use this for who "
1338
- "controls the company, not for all holder positions."
1353
+ "controls the company, not for all holder positions. For Brazilian "
1354
+ "FRE rows, current control holders are restricted to the latest "
1355
+ "source document for the selected reference date when protocols "
1356
+ "identify multiple filed versions."
1339
1357
  ),
1340
1358
  "parameters": {"company_id": PUBLIC_SOURCES_CONVENTIONS["company_id"]},
1341
1359
  "relationships": [
@@ -1351,7 +1369,9 @@ PUBLIC_SOURCES_ENDPOINTS: dict[str, dict[str, Any]] = {
1351
1369
  "client": "AlternativeDataOwnership",
1352
1370
  "description": (
1353
1371
  "Get free-float percentage and share-class details for a company as "
1354
- "a composite object. Use this for investable-float questions."
1372
+ "a composite object. Use this for investable-float questions. "
1373
+ "Brazilian FRE distribution-of-capital versions are ordered "
1374
+ "numerically; returned zero percentages can be valid source values."
1355
1375
  ),
1356
1376
  "parameters": {
1357
1377
  "company_id": PUBLIC_SOURCES_CONVENTIONS["company_id"],
@@ -114,12 +114,16 @@ class AlternativeDataCompanies:
114
114
  Use get_board_changes() for appointment/departure events and
115
115
  get_governance_history() for historical snapshot series.
116
116
 
117
- For Brazilian filings, ``body='board'`` can include Conselho Fiscal
118
- rows alongside Conselho de Administracao rows. For a board-of-directors
119
- answer, filter returned rows by governance_body or role. Committee
120
- responses can include broad aggregate groups such as Outros Comites; do
121
- not infer granular committee names unless they are present in returned
122
- fields.
117
+ For Brazilian filings, the latest FRE raw rows are preferred over
118
+ older materialized snapshots and numeric FRE versions are ordered
119
+ numerically (for example version 13 is newer than version 9).
120
+ ``body='board'`` preserves the historical contract and can include
121
+ Conselho Fiscal rows alongside Conselho de Administracao rows; for a
122
+ board-of-directors answer, filter returned rows by governance_body or
123
+ role. ``body='executive'`` returns one row per person after resolving
124
+ duplicate mixed board/executive FRE rows. Committee responses can
125
+ include broad aggregate groups such as Outros Comites; do not infer
126
+ granular committee names unless they are present in returned fields.
123
127
 
124
128
  Parameters
125
129
  ----------------
@@ -161,7 +165,13 @@ class AlternativeDataCompanies:
161
165
  def get_governance_summary(self, company_id: str) -> dict:
162
166
  """
163
167
  Latest governance snapshot for a company (board size, independence,
164
- committees, CEO name, etc.).
168
+ fiscal council size, executive count, committees, CEO name, etc.).
169
+ For Brazilian companies, the API derives current counts from the
170
+ latest available FRE raw filing when present, exposes
171
+ latest_reference_date/latest_version/latest_document_id and can mark
172
+ structure_source='fre_raw'. This avoids stale materialized summaries
173
+ and fixes B3 tickers that resolve through alternate traded classes
174
+ such as units.
165
175
  Use get_board() for individual directors/officers and
166
176
  AlternativeDataOwnership.get_ownership_free_float() for detailed
167
177
  free-float breakdowns.
@@ -73,10 +73,11 @@ class AlternativeDataOwnership:
73
73
  filter. For Brazilian ownership questions, call get_ownership_current(),
74
74
  get_ownership_control_group(), get_ownership_free_float() and
75
75
  get_ownership_official_notices() when this endpoint returns no rows.
76
- Some responses can include multiple rows for the same holder across
77
- share classes, ownership categories, filings or source protocols;
78
- inspect category, class, protocol/source and reference date before
79
- aggregating percentages.
76
+ The API deduplicates repeated rows from older FRE source documents for
77
+ the same reference date where possible, while still preserving distinct
78
+ rows for the same holder when they represent different share classes,
79
+ ownership categories or roles. Inspect category, class, protocol/source
80
+ and reference date before aggregating percentages.
80
81
 
81
82
  Parameters
82
83
  ----------------
@@ -108,7 +109,9 @@ class AlternativeDataOwnership:
108
109
  Use this as the primary current ownership summary when top-shareholder
109
110
  snapshots are empty or when a compact ownership object is sufficient.
110
111
  Reference dates usually come from CVM/FRE reporting periods or parsed
111
- IR structures and are not necessarily strict as-of timestamps.
112
+ IR structures and are not necessarily strict as-of timestamps. For
113
+ Brazilian FRE data, control/free-float blocks are based on the latest
114
+ source document for the selected reference date when available.
112
115
 
113
116
  Parameters
114
117
  ----------------
@@ -291,7 +294,9 @@ class AlternativeDataOwnership:
291
294
  Use this for who controls the company; use get_shareholder_holdings()
292
295
  for a reverse lookup of one holder across companies.
293
296
  Reference dates usually come from CVM/FRE reporting periods and can
294
- denote a filing year/base period rather than the load date.
297
+ denote a filing year/base period rather than the load date. The API
298
+ filters current control rows to the latest FRE source document for the
299
+ selected reference date when protocols identify multiple filed versions.
295
300
 
296
301
  Parameters
297
302
  ----------------
@@ -306,7 +311,10 @@ class AlternativeDataOwnership:
306
311
  Free float breakdown for a company.
307
312
  Reference dates usually come from CVM/FRE reporting periods or parsed
308
313
  IR structures and can denote a filing year/base period rather than the
309
- load date.
314
+ load date. For Brazilian FRE distribution-of-capital tables, numeric
315
+ versions are ordered numerically so version 13 is treated as newer than
316
+ version 9. Returned zero values can be valid source values rather than
317
+ missing data.
310
318
 
311
319
  Parameters
312
320
  ----------------
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: btgsolutions_dataservices_python_client
3
- Version: 4.5.0
3
+ Version: 4.5.1
4
4
  Summary: Python package containing several classes and data for extracting and manipulating market and trading data.
5
5
  Home-page: https://github.com/BTG-Pactual-Solutions/btgsolutions-dataservices-python-client
6
6
  Author: BTG Solutions Data Services powered by BTG Pactual Solutions
@@ -620,6 +620,12 @@ companies.get_disclosures(company_id='PETR4', document_type='repurchase')
620
620
  companies.get_disclosures(company_id='PETR4', document_type='insider')
621
621
  ```
622
622
 
623
+ For Brazilian governance endpoints, current board and summary responses prefer
624
+ the latest raw FRE filing when available. Returned governance summaries can
625
+ include `latest_reference_date`, `latest_version`, `latest_document_id` and
626
+ `structure_source`; alternate B3 tickers/units such as `BPAC11` can resolve to
627
+ the underlying listed company when covered by the source metadata.
628
+
623
629
  #### Alternative Data - People
624
630
 
625
631
  ```python
@@ -661,6 +667,13 @@ ownership.get_institutional_holders(identifier='VALE3')
661
667
  ownership.get_fund_holders(identifier='PETR4', identifier_type='b3_ticker')
662
668
  ```
663
669
 
670
+ For Brazilian ownership/free-float endpoints, current control and free-float
671
+ responses use the latest FRE source document/version for the selected reference
672
+ date when available. Repeated older source documents are deduplicated where
673
+ possible, while distinct rows for the same holder across classes, roles or
674
+ ownership categories are preserved. Zero free-float or independence percentages
675
+ can be valid source values, not missing data.
676
+
664
677
  #### Alternative Data - Macro & Markets
665
678
 
666
679
  ```python