feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 11
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/alisson/brapi-359f89054dab22e3dffa5cafe68b850e29aa8ae5db8255c05b7725eb62f7de35.yml
-openapi_spec_hash: 601cd66134e2fbafe8a4b5af630696e6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/alisson/brapi-6c102060673bc8962504a7e74d88104e79435ac406ba732b58337b7255e4efa2.yml
+openapi_spec_hash: a602ef75a89ae4b3fb3da40fa6d9992d
 config_hash: 14da4c1963f3e0764a3e82d626a1d762

src/brapi/resources/available.py

@@ -57,54 +57,19 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AvailableListResponse:
         """
-        Retorna a lista completa de **ações e índices** disponíveis para consulta na API
-        brapi.
+        Lista todos os ativos que a API aceita: ações, FIIs, BDRs e ETFs da B3, mais os
+        índices com cotação disponível.
 
-        ### Funcionalidades
-
-        - **Ações brasileiras:** Todas as ações, FIIs, BDRs e ETFs negociados na bolsa
-          brasileira
-        - **Índices:** Índices do mercado brasileiro com cotação disponível na API
-        - **Filtro por Nome:** Use `search` para filtrar por código ou nome do ativo
-
-        ### Características
-
-        - **Sem Autenticação:** Este endpoint é **público** e não requer token
-        - **Cache:** Dados cacheados por 15 minutos
-        - **Atualização automática:** Conforme novos ativos são listados na bolsa
-          brasileira
-
-        ### Exemplos de Uso
+        Filtre por código ou nome com `search`.
 
         ```bash
-        # Listar todos os ativos
-        curl "https://brapi.dev/api/available"
-
-        # Buscar por código de ticker
         curl "https://brapi.dev/api/available?search=PETR"
-
-        # Buscar por nome da empresa
-        curl "https://brapi.dev/api/available?search=banco"
         ```
 
-        ### Índices Disponíveis
-
-        - `^BVSP` - Ibovespa (Índice Bovespa)
-        - `IFIX.SA` - Índice de Fundos Imobiliários
-
-        ### Campos da Resposta
-
-        - `stocks` - Array com códigos das ações (ex: ["PETR4", "VALE3", "ITUB4", ...])
-        - `indexes` - Array com códigos dos índices (ex: ["^BVSP", "IFIX.SA"])
-
-        ### Como Usar
-
-        Use os códigos retornados como parâmetro no endpoint `/api/quote/{tickers}` para
-        obter cotações detalhadas.
-
-        **Fonte:** Bolsa de Valores do Brasil
+        Endpoint público, sem token. A resposta fica em cache por 15 minutos e é
+        atualizada conforme novos ativos entram na bolsa.
 
-        **Plano Mínimo:** Gratuito **Autenticação:** Não necessária (Público)
+        Para busca com filtros por setor e tipo, `/api/v2/tickers` é mais completo.
 
         Args:
           search: Filtrar ações e índices por nome ou código
@@ -166,54 +131,19 @@ async def list(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AvailableListResponse:
         """
-        Retorna a lista completa de **ações e índices** disponíveis para consulta na API
-        brapi.
+        Lista todos os ativos que a API aceita: ações, FIIs, BDRs e ETFs da B3, mais os
+        índices com cotação disponível.
 
-        ### Funcionalidades
-
-        - **Ações brasileiras:** Todas as ações, FIIs, BDRs e ETFs negociados na bolsa
-          brasileira
-        - **Índices:** Índices do mercado brasileiro com cotação disponível na API
-        - **Filtro por Nome:** Use `search` para filtrar por código ou nome do ativo
-
-        ### Características
-
-        - **Sem Autenticação:** Este endpoint é **público** e não requer token
-        - **Cache:** Dados cacheados por 15 minutos
-        - **Atualização automática:** Conforme novos ativos são listados na bolsa
-          brasileira
-
-        ### Exemplos de Uso
+        Filtre por código ou nome com `search`.
 
         ```bash
-        # Listar todos os ativos
-        curl "https://brapi.dev/api/available"
-
-        # Buscar por código de ticker
         curl "https://brapi.dev/api/available?search=PETR"
-
-        # Buscar por nome da empresa
-        curl "https://brapi.dev/api/available?search=banco"
         ```
 
-        ### Índices Disponíveis
-
-        - `^BVSP` - Ibovespa (Índice Bovespa)
-        - `IFIX.SA` - Índice de Fundos Imobiliários
-
-        ### Campos da Resposta
-
-        - `stocks` - Array com códigos das ações (ex: ["PETR4", "VALE3", "ITUB4", ...])
-        - `indexes` - Array com códigos dos índices (ex: ["^BVSP", "IFIX.SA"])
-
-        ### Como Usar
-
-        Use os códigos retornados como parâmetro no endpoint `/api/quote/{tickers}` para
-        obter cotações detalhadas.
-
-        **Fonte:** Bolsa de Valores do Brasil
+        Endpoint público, sem token. A resposta fica em cache por 15 minutos e é
+        atualizada conforme novos ativos entram na bolsa.
 
-        **Plano Mínimo:** Gratuito **Autenticação:** Não necessária (Público)
+        Para busca com filtros por setor e tipo, `/api/v2/tickers` é mais completo.
 
         Args:
           search: Filtrar ações e índices por nome ou código