fix(api): resolve AXIA share conversions without merging history

Stainless-Generated-From: 34c2bbb

Author: brapi-sdk-bot

scripts/mock

@@ -82,6 +82,10 @@ def retrieve(
         Este é o endpoint original da brapi. Ele continua ativo e não tem data de
         remoção.
 
+        AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Seus preços históricos e
+        proventos continuam separados por classe. Os campos `historicalSymbol` e
+        `dividendsSymbol` identificam o ticker desses históricos.
+
         A resposta sempre traz a cotação: preço, variação, volume, máxima e mínima do
         dia, faixa de 52 semanas e `marketCap`. Estes parâmetros adicionam outros dados:
 
@@ -326,6 +330,10 @@ async def retrieve(
         Este é o endpoint original da brapi. Ele continua ativo e não tem data de
         remoção.
 
+        AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Seus preços históricos e
+        proventos continuam separados por classe. Os campos `historicalSymbol` e
+        `dividendsSymbol` identificam o ticker desses históricos.
+
         A resposta sempre traz a cotação: preço, variação, volume, máxima e mínima do
         dia, faixa de 52 semanas e `marketCap`. Estes parâmetros adicionam outros dados:
 

src/brapi/resources/quote.py

@@ -223,6 +223,9 @@ def dividends(
         Use para calcular dividend yield, montar calendários de proventos e registrar
         proventos em carteiras.
 
+        Em conversões de ações, os proventos de cada classe permanecem separados. Uma
+        consulta por AXIA6 retorna os proventos de AXIA6 e ELET6.
+
         `lastDatePrior` é a data-com, o último dia para comprar a ação e ter direito ao
         provento. `exDate` é a data ex, o primeiro dia sem esse direito. `exDate` pode
         ser nulo.
@@ -379,6 +382,9 @@ def historical(
 
         Use para gráficos, backtests e cálculo de retorno.
 
+        Em conversões de ações, use o ticker original para consultar o histórico daquela
+        classe. Por exemplo, AXIA6 mantém seu próprio histórico.
+
         Defina a janela com `range` e `interval`, por exemplo `range=1y&interval=1d`, ou
         com `startDate` e `endDate`. O padrão é `range=1mo` e `interval=1d`.
 
@@ -586,6 +592,9 @@ def quote(
         Um ticker antigo é trocado pelo ticker atual. Nesse caso, `changed` é `true` e
         `requestedSymbol` guarda o ticker enviado.
 
+        AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Consulte a resolução de
+        tickers para ver a proporção de conversão.
+
         Para a série de preços, use o
         [histórico de preços](https://brapi.dev/docs/acoes/historico). Para achar
         tickers válidos, use a [lista de tickers](https://brapi.dev/docs/tickers).
@@ -930,6 +939,9 @@ async def dividends(
         Use para calcular dividend yield, montar calendários de proventos e registrar
         proventos em carteiras.
 
+        Em conversões de ações, os proventos de cada classe permanecem separados. Uma
+        consulta por AXIA6 retorna os proventos de AXIA6 e ELET6.
+
         `lastDatePrior` é a data-com, o último dia para comprar a ação e ter direito ao
         provento. `exDate` é a data ex, o primeiro dia sem esse direito. `exDate` pode
         ser nulo.
@@ -1086,6 +1098,9 @@ async def historical(
 
         Use para gráficos, backtests e cálculo de retorno.
 
+        Em conversões de ações, use o ticker original para consultar o histórico daquela
+        classe. Por exemplo, AXIA6 mantém seu próprio histórico.
+
         Defina a janela com `range` e `interval`, por exemplo `range=1y&interval=1d`, ou
         com `startDate` e `endDate`. O padrão é `range=1mo` e `interval=1d`.
 
@@ -1293,6 +1308,9 @@ async def quote(
         Um ticker antigo é trocado pelo ticker atual. Nesse caso, `changed` é `true` e
         `requestedSymbol` guarda o ticker enviado.
 
+        AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Consulte a resolução de
+        tickers para ver a proporção de conversão.
+
         Para a série de preços, use o
         [histórico de preços](https://brapi.dev/docs/acoes/historico). Para achar
         tickers válidos, use a [lista de tickers](https://brapi.dev/docs/tickers).

src/brapi/resources/v2/stocks.py

@@ -161,6 +161,9 @@ def coverage(
         com `status` igual a `unknown` e links de busca. Um ticker de opção vem com
         `wrong_endpoint` e links para os endpoints de opções.
 
+        Em conversões de ações, os links de histórico e proventos usam o ticker da
+        classe original.
+
         Este endpoint não traz dados de mercado. Não exige token.
 
         Args:
@@ -203,6 +206,9 @@ def renames(
         """
         Mudanças de ticker, com o ticker antigo, o novo, o atual e a data efetiva.
 
+        Conversões de ações incluem `conversionRatio`, a quantidade de ações novas por
+        ação antiga. O histórico de cada classe permanece separado.
+
         Use para explicar por que um ticker antigo leva a outro e para corrigir séries
         salvas com o ticker antigo.
 
@@ -274,6 +280,9 @@ def resolve(
         repetidos. `status` é `renamed` quando o ticker mudou e `active` quando não há
         renome conhecido.
 
+        Conversões também retornam `renamed`. `conversionRatio` informa a quantidade de
+        ações novas por ação antiga. Use o ticker original para consultar seu histórico.
+
         Este endpoint não confirma se o ticker existe. Para isso, use a
         [cobertura por ticker](https://brapi.dev/docs/tickers/cobertura).
 
@@ -438,6 +447,9 @@ async def coverage(
         com `status` igual a `unknown` e links de busca. Um ticker de opção vem com
         `wrong_endpoint` e links para os endpoints de opções.
 
+        Em conversões de ações, os links de histórico e proventos usam o ticker da
+        classe original.
+
         Este endpoint não traz dados de mercado. Não exige token.
 
         Args:
@@ -480,6 +492,9 @@ async def renames(
         """
         Mudanças de ticker, com o ticker antigo, o novo, o atual e a data efetiva.
 
+        Conversões de ações incluem `conversionRatio`, a quantidade de ações novas por
+        ação antiga. O histórico de cada classe permanece separado.
+
         Use para explicar por que um ticker antigo leva a outro e para corrigir séries
         salvas com o ticker antigo.
 
@@ -551,6 +566,9 @@ async def resolve(
         repetidos. `status` é `renamed` quando o ticker mudou e `active` quando não há
         renome conhecido.
 
+        Conversões também retornam `renamed`. `conversionRatio` informa a quantidade de
+        ações novas por ação antiga. Use o ticker original para consultar seu histórico.
+
         Este endpoint não confirma se o ticker existe. Para isso, use a
         [cobertura por ticker](https://brapi.dev/docs/tickers/cobertura).
 

src/brapi/resources/v2/tickers.py

@@ -251,6 +251,9 @@ class Result(BaseModel):
     `/api/v2/stocks/dividends`, não exige esse parâmetro.
     """
 
+    dividends_symbol: Optional[str] = FieldInfo(alias="dividendsSymbol", default=None)
+    """Ticker do histórico de proventos quando ele difere do ticker da cotação."""
+
     financial_data: Optional[FinancialDataEntry] = FieldInfo(alias="financialData", default=None)
     """Dados financeiros dos últimos 12 meses."""
 
@@ -267,6 +270,12 @@ class Result(BaseModel):
     )
     """Série de preços. Vem quando a requisição define a janela."""
 
+    historical_symbol: Optional[str] = FieldInfo(alias="historicalSymbol", default=None)
+    """Ticker do histórico de preços quando ele difere do ticker da cotação."""
+
+    requested_symbol: Optional[str] = FieldInfo(alias="requestedSymbol", default=None)
+    """Ticker enviado quando a cotação pertence a outro ticker."""
+
     summary_profile: Optional[ResultSummaryProfile] = FieldInfo(alias="summaryProfile", default=None)
     """Cadastro da empresa. Vem com o módulo `summaryProfile`."""
 

src/brapi/types/quote_retrieve_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Optional
 from datetime import datetime
 
 from pydantic import Field as FieldInfo
@@ -15,14 +15,20 @@ class Result(BaseModel):
     """Ticker atual. Se o ativo mudou de ticker mais de uma vez, é o último."""
 
     effective_date: str = FieldInfo(alias="effectiveDate")
-    """Data efetiva do renome no formato YYYY-MM-DD."""
+    """Data de início da negociação do novo ticker no formato YYYY-MM-DD."""
 
     new_symbol: str = FieldInfo(alias="newSymbol")
     """Ticker novo divulgado no evento."""
 
     old_symbol: str = FieldInfo(alias="oldSymbol")
     """Ticker antigo."""
 
+    conversion_ratio: Optional[float] = FieldInfo(alias="conversionRatio", default=None)
+    """Quantidade de ações novas por ação antiga.
+
+    Presente quando houve conversão de ações.
+    """
+
 
 class TickerRenamesResponse(BaseModel):
     count: float

src/brapi/types/v2/ticker_renames_response.py

@@ -16,7 +16,7 @@ class Result(BaseModel):
     """`true` quando o ticker enviado foi trocado pelo ticker atual."""
 
     effective_date: Optional[str] = FieldInfo(alias="effectiveDate", default=None)
-    """Data efetiva do renome. Nulo quando não há renome."""
+    """Data de início da negociação do novo ticker. Nulo quando não há mudança."""
 
     requested_symbol: str = FieldInfo(alias="requestedSymbol")
     """Ticker enviado na requisição."""
@@ -30,6 +30,12 @@ class Result(BaseModel):
     symbol: str
     """Ticker atual. Use este nas próximas consultas."""
 
+    conversion_ratio: Optional[float] = FieldInfo(alias="conversionRatio", default=None)
+    """Quantidade de ações novas por ação antiga.
+
+    Presente quando houve conversão de ações.
+    """
+
 
 class TickerResolveResponse(BaseModel):
     requested_at: datetime = FieldInfo(alias="requestedAt")